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Jeff Langr 

资深 程序 员 ，C++ 语 言 专家 ， 曾 在 Bob 
大 叔 的 Object Mentor 公 司 工 作 ， 后 创建 
Langr Software Solutions 公 司 。 出 版 
过 多 本 与 测试 驱动 开发 相关 的 图 书 ， 
如 《Agile Java: 测试 驱动 开发 的 编程 技 
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毕业 于 吉林 大 学 计算 机 科学 与 技术 学 院 。 
先后 就 职 于 Intel 和 ARM ， 曾 多 年 从 事 显 
卡 与 3D 图 形 API (OpenGL 和 Direct3D ) 
驱动 程序 研发 工作 。 现 今 从 事 虚 拟 现实 
方面 的 研发 工作 。 个 人 的 主要 专注 点 为 
操作 系统 和 3D 图 形 的 相关 技术 ， 此 外 对 
移动 应 用 和 云 计 算 技术 也 颇 感 兴趣 。 


秦 涛 

毕业 于 浙江 大 学 信息 学 院 控制 系 。 先 后 
就 职 于 AMD、lntel、ARM ， 曾 多 年 从 
事 显 卡 驱 动 研 发 工作 。 目 前 从 事 虚 拟 现 
实 方面 的 研发 工作 。 
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内 容 提 要 


本 书 是 一 本 关于 设计 原则 、 编 程 实践 、 测 试 驱动 开发 的 指南 ， 





法 构建 高 性 能 解决 方案 。 全 1 














EJE 11 章 ， 涵 盖 测 试 驱 动 开 发 的 基本 


旨 在 帮助 C++ 程序 员 用 测试 驱动 开发 方 








[ 作 方 式 、 潜 在 好 处 、 怎 样 利用 测试 驱动 


开发 解决 设计 缺陷 、 测 试 驱动 开发 的 难点 和 成 本 、 怎 样 利用 测试 驱动 开发 减少 甚至 免除 调试 工作 ， 以 及 如 
何 长 时 间 维持 测试 驱动 开发 。 
本 书 适合 所 有 技术 层次 的 C++ 程序 员 阅 读 。 
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Jeff Langr 又 写 了 一 本 很 棒 的 书 。 这 一 次 他 把 测试 驱动 开发 引入 到 C++ 世界 。Jeff 的 示例 让 我 
们 近 距 离 地 领略 到 好 的 测试 驱动 开发 方法 简约 的 一 面 。 他 解释 了 为 什么 要 以 这 种 方式 工作 , 然后 
提出 了 重要 的 实践 细节 ,涉及 测试 蔡 身 、 与 遗留 代码 打交道 的 方法 、 对 付 多 线程 代码 ,还 有 很 多 
其 他 的 内 容 。 每 个 使 用 C++ 的 开发 者 都 应 该 拥有 这 本 书 。 


Ron Jeffries， 极 限 编程 方法 学 创始 人 之 一 ，《 软 件 开发 本 资 论 》 作 者 














Jeff Langr 写 了 近年 来 最 好 的 一 本 C++ 图 书 。《 C++ 程序 设计 实践 与 技巧 : 测试 驱动 开发 》 是 
理论 与 实践 的 完美 结合 。 书 中 对 抽象 概念 的 解释 清晰 明了 、 妙 趣 横生 ,需要 时 ,细节 之 处 也 是 唾 
手 可 得 。 本 书 无 疑 是 C++ 和 测试 驱动 开发 方面 的 经 典 之 作 。 


Michael D. Hill， 极 限 编程 方法 教练 和 作家 

















Je 个 Langr 是 软件 开发 方面 的 专家 。 他 在 这 本 书 中 分 享 了 关于 构建 优秀 软件 的 智慧 。 这 本 书 不 
是 讲 测试 的 , 但 是 你 依然 能 学 到 重要 的 测试 技巧 。 本 书 是 通过 测试 驱动 开发 方法 来 改善 你 的 技术 、 
代码 、 产 品 和 生活 。 无 论 你 是 哪个 层次 的 C++ 程 序 员 ，Jeff 都 将 向 你 展示 为 什么 使 用 测试 驱动 开 
发 能 构建 出 更 好 的 C++ 软件 产品 ， 以 及 如 何 做 到 。 


James W. Grenning，《 测 试 驱动 的 谋 入 式 C 语 言 开发 》 作 者 












































译 者 F 


回想 当初 ,其 实 我 刚 开 始 打算 翻译 的 是 一 本 关于 调试 的 图 书 ， 后 因 其 他 缘由 翻译 了 此 书 。 当 
时 想 的 是 ， 唔 ， 测 试 驱动 开发 在 平常 的 开发 过 程 中 也 会 用 到 ， 应 该 不 算 陌 生 。 看 到 本 书 原稿 后 ， 
我 便 坚定 了 翻译 此 书 的 决心 。 一 方面 ， 本 书 就 像 一 本 关于 测试 驱动 开发 的 《一 万 个 为 什么 》 它 






































好 的 解决 方案 ?你 需要 什么 样 的 测试 ?测试 该 怎么 写 ? 测试 需要 维护 吗 ? 测试 驱动 开发 中 所 编 
写 的 单元 测试 和 非 测 试 驱 动 开发 中 所 编写 的 单元 测试 有 何 区 别 ? 总 之 , 几乎 你 遇 到 的 疑惑 , 本 书 
中 都 有 阐述 。 另 一 方面 ， 它 是 以 一 个 个 示例 的 方式 来 阐述 的 ， 代 入 感 非常 强 。 


回头 看 测试 驱动 开发 本 身 ， 它 是 早期 XP (eXtreme Programming ) 运动 的 一 部 分 ， 并 且 当 下 
的 众多 敏捷 开发 团队 也 大 多 采用 测试 驱动 开发 或 其 变种 。 测 试 驱 动 开 发 的 增 量 开发 和 敏捷 流程 相 
契合 ， 能 够 提供 更 快 的 反馈 ， 而 快速 的 反馈 意味 着 开发 将 更 加 精准 和 灵活 。 另 外 , 测试 驱动 开发 
中 所 编写 的 测试 会 让 你 在 不 断 调整 代码 的 过 程 中 不 轻易 破坏 已 有 的 行为 。 人 敏捷 专家 Bob 大 叔 曾 声 
称 他 的 Fitness 有 将 近 6.4 万 行 代码 ， 而 测试 占据 了 2.8 万 行 。 这 些 测试 可 在 90 秒 内 运行 一 遍 。 后 来 
Fitness 中 又 加 入 了 2 万 行 代码 ， 而 整体 代码 的 缺陷 仅 为 10 多 个 ， 这 些 测试 显然 为 代码 的 持续 修改 
和 快速 发 布 夯 实 了 基础 。 


测试 驱动 开发 的 固有 周期 可 以 轻松 地 将 你 带 入 一 个 有 序 的 开发 轨道 。 在 每 个 周期 中 ,你 将 专 
注 于 思考 真正 的 需求 、 解 决 方案 及 设计 重 构 。 它 将 你 置身 于 一 个 框 寻 下， RIBERA TRU 
所 需要 的 技能 。 在 测试 的 编写 阶段 ， 你 会 更 加 细致 地 思考 需求 ， 考 察 代码 覆盖 率 等 ; 在 编写 产品 
代码 阶段 ， 你 可 以 专注 于 初始 架构 设计 和 编程 实践 ， 在 代码 重 构 期 ， 除 了 重新 考量 架构 ， 你 还 可 
以 做 任何 你 想 做 的 优化 。 当 然 ， 有 序 的 开发 轨道 并 不 意味 着 一 路 顺畅 你 依然 会 在 每 个 时 期 遇 到 
各 类 挑战 ， 这 时 你 需要 根据 形势 作出 正确 的 判断 和 决定 。 

刚 开始 接触 测试 驱动 开发 的 开发 者 可 能 会 觉得 用 这 种 开发 方式 节奏 有 点 慢 。 可 能 慢 在 写 测试 
(下 一 个 测试 是 什么 ,测试 的 命名 ,怎么 写 测试 )， 也 可 能 慢 在 审阅 和 重 构 。 一 开始 ， 你 花 在 测试 
上 的 时 间 可 能 要 多 于 开发 产品 代码 的 时 间 ， 但 坚持 住 ， 你 所 作出 的 努力 都 会 得 到 回报 的 。 不 知道 
读者 朋友 们 有 没有 过 练习 一 门 武术 的 经 历 。 译 者 有 幸 曾 跟随 过 一 位 旅居 上 海 的 华人 练习 咏 春 直至 
他 离开 上 海 ， 师 传经 常 提醒 我 ,有 的 动作 要 慢 慢 练 ， 慢 到 别人 几乎 看 不 出 来 你 在 动 。 所 谓 天 下 起 
功 ， 唯 快 不 破 ! 这 个 快 其 实 是 无 数 慢 束 训练 量变 后 所 呈现 的 质变 。 在 修 习 测 试 驱 动 开 发 时 ， 有 时 
候 你 也 要 慢 慢 做 。 在 这 个 慢 的 过 程 中 你 一 定 会 看 到 以 前 没有 看 到 过 的 风景 。 









































































































































测试 驱动 开发 易学 难 精 ， 其 原因 在 于 各 类 软件 或 其 模块 的 行为 复杂 度 不 一 。 此 外 , 测试 驱动 
开发 的 内 容 繁杂 , 在 总 体 呈 优 的 情况 下 也 存 有 一 些 缺 点 。 在 运用 测试 驱动 开发 时 ， 必 要 时 需 结 合 
所 开发 软件 的 特点 ,做 到 扬弃 地 使 用 。 最 后 ,测试 驱动 开发 符合 事物 发 展 的 一 般 规律 ， 其 自身 也 
在 不 断 发 展 , 本 书 只 能 算是 引领 你 登 党 入室 的 第 一 课 ， 所 以 不 要 止步 于 此 ! 要 不 断 学 习 、 实 践 和 
总 结 。 当 然 ， 除 了 技术 上 的 因素 ， 处 于 乐于 推行 测试 驱动 开发 的 工作 环境 也 是 十 分 必要 的 。 坦 白 
讲 ， 我 第 一 次 在 生产 环境 下 试图 使 用 真正 的 测试 驱动 开发 时 ， 过 程 还 是 挺 狠 狐 的 。 
翻译 是 一 个 学 习 、 积 淀 的 过 程 ， 当 然 也 是 艰辛 的 。 感 谢 我 的 家 人 ， 特别 是 我 的 麦子 从 一 开始 
就 非常 支持 我 , 翻译 的 过 程 占据 了 大 量 本 可 以 陪伴 家 人 的 时 间 , 但 是 你 们 却 一 如 既往 地 给 我 支持 。 

在 翻译 本 书 的 后 期 , 由 于 工作 和 生活 上 的 事情 使 得 翻译 时 间 缩 减 , 因此 我 邀请 了 好 友 秦 涛 帮 
忙 翻 译 第 9 章 和 第 10 章 。 多 谢 你 在 繁忙 之 中 拔 元 相助 ， 使 得 翻译 得 以 及 时 完成 。 

感谢 朱 狗 老师 从 一 开始 就 给 予 的 信任 和 支持 。 感谢 各 位 编辑 老师 为 本 书 付 出 的 辛勤 汗水 。 没 
有 你 们 的 帮助 和 支持 ， 很 难 想象 出 版 本 书 是 怎样 的 过 程 。 

由 于 时 间 和 水 平 有 限 , 文中 肯定 存 有 一 些 瑕 辛 , 或 者 读者 朋友 们 有 什么 问题 ,都 可 以 发 邮件 
至 fei_faith@outlook.com 作 进一步 讨论 。 


最 后 以 Langr 为 原 书 提供 的 副标题 与 各 位 程序 设计 同仁 共 揭 : Code Better, Sleep Better! 











































































































余 飞 


2016/10/10， 上 海 
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不 要 被 书 名 误导 。 

我 的 意思 是 ， 这 是 一 本 关于 设计 原则 、 编 码 实践 、 测 试 驱 动 开 发 和 技艺 的 非常 非常 好 的 书 ， 
却 起 了 个 “Modern C++ Programming with Test-Driven Development:Code Better,Sleep Better” 的 名 
"E. MI 


不 要 误会 ， 这 本 书 的 确 是 关于 现代 C++ 编程 的 。 如 果 你 是 C++ 开发 者 ， 你 会 喜欢 上 书 中 所 有 
的 代码 。 这 本 书 中 充满 了 有 趣 的 、 编 写 良好 的 C++ 人 代码。 事实 上 ， 我 认为 代码 略 多 于 文字 描述 。 
翻阅 一 下 这 本 书 吧 。 你 能 找到 没有 代码 的 一 页 吗 ? 我 敢 打赌 没 多 少 ! 所 以 ,如 果 你 正在 找 一 本 现 
代 C++ 实 践 方面 配 以 大 量 示例 的 好 书 ， 那 么 你 算是 找 对 了 1! 

但 是 ， 这 本 书 讨论 的 内 容 远 不 止 现代 C++ 编程 ， 而 是 讲 了 很 多 很 多 ! 

首先 ， 这 是 我 见 过 测试 驱动 开发 方面 内 容 最 完整 、 论 述 最 好 的 书 (我 看 过 的 书 太 多 了 ) JL 
乎 在 过 去 十 五 年 里 , 未 经 讲述 的 每 个 测试 驱动 开发 问题 在 这 本 书 中 都 有 讨论 。 从 脆弱 性 测试 到 模 
拟 (mock )， 从 伦敦 流派 ?到 Cleveland 流 派 ， 从 Single Assert 到 Given-When-Then”， 这 本 书 中 都 讨 
论 了 ， 而 且 还 不 止 这 些 。 此 外 ,这 本 书 并 非 泛 泛 地 概述 一 些 没 有 关联 的 问题 。 相 反 ， 它 详 述 每 个 
问题 ， 配 以 示例 和 讨论 。 可 谓 是 问题 现 于 代码 ， 也 解 于 代码 。 

需要 先 成 为 C++ 程序 员 才 能 理解 这 本 书 吗 ? 当然 不 需要 。 书 中 的 C++ 代码 十 分 整洁 ， 概 念 也 
十 分 清晰 ， 所 以 ，Java 、C# 、C 甚 至 Ruby 程 序 员 理解 起 来 都 没 问 题 。 

其 次 , 书 中 讲述 了 设计 原则 ! 谢 天 谢 地 ， 这 本 书 是 一 本 设计 教程 ! 它 带 你 遍及 令 人 目不暇接 
的 原理 、 问 题 和 技巧 。 从 单一 功能 原则 到 依赖 倒置 原则 ， 从 接口 隔离 原则 到 简洁 设计 背后 的 敏捷 
开发 原则 ， 从 DRY ”到 Tell-Don*t-Ask”。 本 书 收 纳 了 各 种 软件 设计 方法 和 方案 ,而且 这 些 方法 就 















































































































































CD 测试 驱动 开发 中 有 多 种 流派 ， 其 中 伦敦 流派 起 源 于 创立 于 伦敦 的 ETC (Extreme Tuesday Club )， 这 个 俱乐部 提倡 

敏捷 开发 。 一 一 译 者 注 
(2) Give-When-Then 是 一 种 指导 编写 测试 的 模板 。 可 以 参考 http://guide.agilealliance.org/guide/gwt.html。 一 一 译 者 注 
& DRY Æ Don’t Repeat Yourself 的 缩写 ， 此 原则 倡导 消除 各 式 各 样 的 信息 元 余 。 更 多 内 容 请 参考 

https://en.wikipedia.org/wiki/Don9627t repeat yourself。 一 一 译 者 注 
(4) 这 个 原则 倡导 一 个 对 象 应 该 命令 其 他 对 象 该 做 什么 ， 而 不 是 去 查询 其 他 对 象 的 状态 来 决定 做 什么 。 遵 循 此 原则 会 
带 来 更 好 的 封装 性 。 一 一 译 者 注 
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呈现 在 真实 问题 和 真实 代码 解决 方案 之 中 。 
之 后 , 书 中 还 讲述 了 编码 实践 和 技巧 。 这 本 书 通 篇 都 在 讲解 这 些 内 容 , 从 小 方法 到 结对 编程 ， 


从 编程 招式 到 变量 名 。 书 中 不 仅 有 大 量 的 代码 供 你 一 宕 优秀 的 实践 和 技巧 , 作者 还 以 恰当 的 讨论 
和 演绎 入 木 三 分 地 解释 了 这 些 主题 。 


是 的 ， 书 名 是 彻底 的 败笔 。 这 不 是 一 本 讲 C++ 的 书 ， 而 是 一 本 论述 优秀 软件 开发 工艺 的 书 ， 
只 是 恰巧 使 用 C+ 来 书写 示例 黑 了 。 真 的 ， 书 名 应 该 叫 “ 软 件 技艺 : 现代 C++ 示例 ”( Software 
Craftsmanship: With Examples in Modern C++ )。 


所 以 , 如 果 你 是 一 名 Java 程 序 员 , 或 者 C# 程 序 员 , 抑或 是 Ruby、 Python, .PHP 、VB 甚 至 COBOL 
程序 员 ， 都 会 有 阅读 此 书 的 冲动 。 不 要 被 封面 上 的 C++ 字样 吓 到 。 不 管 怎样 ， 先 读 一 读 。 阅 读 的 
时 候 ， 也 读 一 读 附带 的 代码 。 你 会 发 现 它 很 容易 理解 。 在 学 习 好 的 设计 原则 、 编 码 技巧 、 技 艺 和 
测试 驱动 开发 时 ， 你 或 许 会 发 现 学 一 点 点 C++ 其 实 也 无 妨 。 
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Object Mentor 8] €] 44 A. 
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尽管 当下 程序 设计 语言 呈现 爆炸 式 发 展 ，C++ 却 一 如 既往 地 坚挺 。 在 2013 年 7 月 Tiobe 最 受 欢 


























对 于 构建 高 性 能 解决 方案 ，C++ 依 然 是 最 好 的 选择 之 一 。 如 果 你 所 在 公司 的 产品 要 与 硬件 集 











迎 的 编程 语言 排行 榜 上 ，C++ 位 居 第 四 ( 最 新 的 排名 可 以 参见 http://wwwi.tiobe.com/index.php/ 
content/paper-info/tpci/index.html )。2011 版 ISO 标 准 ( ISO/IEC 14822:2011， 即 C++11 ) 定义 了 一 些 
新 的 C++ 特性 ， 这 些 特性 可 以 提升 C++ 的 接受 度 ， 至 少 能 减弱 反对 使 用 C++ 的 声音 。 


























成 ,那么 很 有 可 能 公司 已 经 拥有 了 一 个 基于 C++ 的 庞大 系统 。 如 果 你 的 公司 在 20 世 纪 90 年 代 或 更 
早 之 前 就 存在 ， 很 有 可 能 拥有 一 个 使 用 了 很 长 时 间 的 基于 C++ 的 系统 ， 而 且 它 在 未 来 的 几 年 内 也 





不 会 消失 。 




















假设 在 工作 中 使 用 C++， 你 可 能 会 思考 以 下 几 件 事情 。 





程 语言 ? 我 该 怎样 做 才 不 会 自 讨 昔 吃 ? 





开发 工作 。 我 为 什么 要 改变 工作 方式 呢 ? 
a 我 的 职业 前 景 在 哪里 ? 




















a 我 是 一 个 C++ 老手 ， 对 这 门 功能 强大 的 语言 了 如 指 掌 。 











口 现在 是 2013 年 ， 为 什么 我 会 回头 使 用 这 一 难 用 (但 好 玩 ) 并 且 早 在 儿 年 前 就 想 按 弃 的 编 


多 年 来 我 一 直 使 用 它 顺 利 地 进行 





谈 谈 我 自己 吧 ! 我 从 20 世 纪 90 年 代 初 期 开始 使 用 C++, 那个 时 候 还 没有 模板 ( 和 模板 元 编程 )、 


RTTI、STL 和 Boost 这 样 的 东西 。 从 那 时 起 ,我 有 几 次 必须 使 用 这 门 强大 的 语言 ， 
令 人 泪 来 。 和 众多 编程 语言 一 样 ，C++ 也 时 常会 让 你 搬 起 石头 砸 自己 的 脚 ,但 使 用 C+ 
处 是 ， 有 些 时 候 你 不 会 意识 到 即将 要 砸 到 脚 ， 等 真正 发 生 时 已 为 时 过 晚 。 与 使 用 其 他 编程 语言 相 
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比 ， 你 可 能 会 经 受 更 多 的 痛苦 。 





如 果 你 已 经 使 用 C++ 工作 了 很 多 年 ， 可 能 采用 了 许多 惯用 法 来 提高 代码 的 质量 。 在 所 有 编程 
语言 开发 者 中 ， 铁 杆 的 C++ 老手 相对 更 加 仔细 ， 因 为 长 时 间 使 用 C++ 开发 而 不 出 问题 ， 








码 给 予 一 丝 不 苟 的 关注 和 照料 。 








其 露出 如 下 一 些 相 同 的 问题 ， 而 且 会 不 断 地 出 现 。 通 
口 几 千 行 的 巨 量 源 代码 ; 




















但 是 结果 有 点 


| 的 不 同 之 









































需要 对 代 





常 ， 这 些 问 题 和 编程 语言 无 关 : 

















你 或 许 会 想 ， 如 此 精心 照料 ，C++ 系 统 的 代码 质量 应 该 很 高 吧 ! 但 是 ， 大 部 分 C++ 系 统 都 会 








口 & uH E TTTREETU BILD PR; 

OQ 大 量 的 无 用 代码 ; 

口 编译 时 间 超 过 几 个 小 时 ; 

口 居 高 不 下 的 代码 缺陷 数目 ; 

口 快速 修复 导致 遇 辑 复杂 隐 涩 而 难以 安全 地 管理 ; 
口 散落 在 多 个 文件 、 类 和 模块 间 的 重复 代码 ; 

O 使 用 早已 废弃 的 编程 实践 。 


这 些 问 题 不 可 避免 吗 ? 答案 是 可 以 避免 ， 测 试 驱动 开发 (Test-Driven Development, TDD ) 









































正 是 这 样 的 工具 ， 你 可 以 掌握 并 运用 它 来 降低 系统 的 焙 "。 它 甚至 可 以 重 振 你 对 编程 的 热情 。 
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倘若 你 只 是 想 找 份 工作 ， 大 量 的 C++ 工作 机 会 能 让 你 不 悉 就 业 问题 。 但 是 ，C++ 是 一 门 高 度 








究 技 巧 、 很 微妙 的 编程 语言 ,粗心 大 意 地 使 用 会 导致 代码 缺陷 、 间 欣 性 故障 和 旷日持久 的 调试 

















工作 。 这 些 也 会 使 你 的 工作 没有 保障 。 好 在 测试 驱动 开发 帮 得 上 忙 。 


mi 


^. 





往 一 个 庞大 且 存 在 了 很 长 时 间 的 C++ 系统 中 加 入 新 的 功能 通常 很 耗 时 ， 而 且 无 法 估计 进度 。 





是 理解 一 段 代码 然后 修改 几 行 , 有 可 能 要 花费 几 个 小 时 甚至 几 天 。 开 发 者 需要 花 上 数 小 时 等 待 








代码 改动 编译 完成 , 并 且 要 等 待 更 长 的 时 间 去 检测 这 些 改动 是 否 和 现 有 的 系统 完好 集成 , 这 会 导 
致 生产 力 进 一 步 下 降 。 


一 二 
HE 























其 实 这 都 是 可 以 避免 的 。 早 在 20 世 纪 90 年 代 末 , TDD 就 被 用 来 帮助 不 断 往 系统 中 加 入 新 的 特 








， 同 时 保持 C++ 系统 在 可 控 的 范围 内 。( 先 于 代码 写 测试 的 观念 已 经 存在 很 长 一 段 时 间 了 , 但 
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， 正 式 的 TDD 周 期 是 Ward Cunningham 和 Kent Beck 在 《测试 驱动 开发 》 一 书 中 提出 的 。) 

















本 书 的 主要 目的 是 教 你 实际 使 用 TDD 的 系统 方法 。 你 将 会 学 到 : 


口 TDD 的 基本 工作 方式 ; 

口 TDD 的 潜在 好 处 ; 

口 TDD 怎 样 帮助 解决 设计 缺陷 ; 

口 TDD 的 难点 和 成 本 ; 

口 TDD 怎 样 减少 甚至 免除 调试 工作 ; 
口 怎样 长 时 间 维 持 TDD。 














适合 我 和 我 的 系统 吗 





“这 和 单元 测试 有 什么 关系 ? 似乎 并 不 能 帮 到 我 太 多 。 
或 许 你 已 经 尝试 过 单元 测试 , 抑或 正在 努力 为 一 个 旧 系 统 编写 单元 测试 。 TDD 似 乎 对 于 工作 























CD 人 是 热力 学 的 概念 ， 是 在 物质 微观 热 运 动 时 ， 用 以 表达 其 混乱 程度 的 量 。 最 初 由 香农 引入 信息 论 中 ， 用 以 衡量 信 
息 的 不 确定 性 或 随机 性 。 这 里 亦 可 以 表示 软件 系统 混乱 、 不 稳定 的 程度 。 译 者 注 
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在 新 系统 上 的 垃 运 儿 是 好 东西 ， 但 它 能 解决 C+ 系统 上 长 期 存在 的 棘手 的 日 常 问题 吗 ? 


的 确 , TDD 是 一 个 有 用 的 工具 , 但 不 是 对 付 旧 系统 的 良 方 。 虽然 可 以 在 开发 系统 新 特性 时 使 
用 TDD, 但 依然 需要 清理 系统 中 多 年 积累 的 障碍 。 为 了 持续 这 样 的 清理 工作 , 需要 额外 的 战略 和 
战术 ,你 需要 学 习 战 术 性 的 依赖 消除 法 和 安全 的 代码 修改 方法 ,这些 可 以 在 Michael Feathers 的 《 修 
改 代码 的 艺术 》 一 书 中 找到 。 你 还 需要 理解 在 不 引起 很 多 问题 的 情况 下 , 怎样 进行 大 规模 的 重 构 。 
这 方面 的 内 容 可 以 参考 Mikado Method [BE12]。 本 书 也 会 传授 此 类 实践 和 其 他 技术 。 

通常 ， 只 为 努力 阐明 “系统 就 是 这 样 的 ”而 为 现 有 代码 添加 单元 测试 [我 称 之 为 开发 后 测试 
( Test-After Development, TAD ) ]， 收 效 甚 微 。 可 能 投入 了 大 量 人 力 编 写 此 类 测试 ， 但 对 系统 的 
质量 影响 却 很 小 。 

知 要 让 TDD 和 帮助 塑造 系统 , 你 的 设计 要 从 定义 上 是 可 测试 的 。 这 么 做 会 有 所 不 同 , 在 许多 方 
面 要 好 于 未 采用 TDD。 越 懂得 什么 是 好 的 设计 ，TDD 就 越 能 帮 你 达到 此 目的 。” 


为 了 协助 你 转变 思考 设计 的 方式 , 本 书 强 调 潜藏 于 优秀 代码 管理 方法 背后 的 原则 , 如 面向 对 
象 设 计 中 的 SOLID 原 则 ， 这 在 《敏捷 软件 开发 : 原则 、 模 式 与 实践 》 一 书 中 有 所 讲述 。 本 书 将 讨 
论 优秀 的 设计 理念 怎样 保持 持续 的 开发 和 生产 力 ， 还 有 TDD 怎 样 帮助 有 心 的 开发 者 达到 更 一 致 、 
可 靠 的 结果 。 


本 书目 标 读者 


本 书 旨 在 帮助 所 有 技术 层次 的 C++ 程序 员 ， 无 论 是 对 C++ 语言 有 基本 理解 的 新 手 ， 还 是 长 期 
浸 淫 在 语言 秘籍 中 的 老手 。 如 果 已 经 有 一 段 时 间 没 用 C++ 了 ，, 那么 你 会 发 现 TDD 的 快速 反馈 周期 
会 帮助 你 快速 地 重新 拾 起 这 门 编程 语言 。 

尽管 本 书 的 目的 是 传授 TDD, 但 是 无 论 使 用 TDD 的 经 验 是 多 还 是 少 , 你 都 会 有 所 收获 。 如 果 
你 完全 对 编写 单元 测试 没有 概念 的 话 , 我 会 帝 着 你 逐步 地 了 解 TDD 的 基础 知识 。 如 果 你 是 第 一 次 
听 说 TDD， 会 在 本 书 中 发 现 很 多 专家 建议 ， 这 些 建议 以 简单 的 方式 呈现 ， 配 以 直截了当 的 例子 。 
甚至 经 验 老 到 的 测试 驱动 开发 者 也 能 找到 一 些 有 用 的 智慧 结晶 、 有 关 实 践 的 可 靠 理 论 基 础 ,以 及 
一 些 有 待 探索 的 新 主题 。 


如 果 你 是 怀疑 论 者 ， 则 可 以 从 多 个 视角 探索 TDD 。 我 会 在 整 本 书 中 解释 为 什么 我 认为 TDD 
能 够 很 好 地 工作 ,我 也 会 分 享 一 些 它 不 能 很 好 工作 的 经 历 以 及 原因 。 本 书 不 是 一 本 宣传 手册 ， 而 
是 革命 性 技术 的 探索 旅程 ， 令 人 大 开眼 界 。 

各 类 读者 也 会 找到 在 团队 中 发 展 和 维持 TDD 的 办 法 。TDD 很 容易 上 手 , 但 是 你 的 团队 可 能 会 
遇 到 很 多 挑战 。 怎样 避免 你 的 变 曹 不 被 这 些 挑战 折 损 ?怎样 避免 灾难 ?第 11 昔 会 提供 一 些 我 认为 
行 之 有 效 的 方法 。 

















































































































































































































中 一 个 好 的 设计 ， 其 内 部 行为 规整 有 序 。TDD 有 助 于 保持 这 种 好 的 设计 行为 不 变性 。 一 一 译 者 注 











阅读 前 提 


为 了 使 用 随 书 附带 的 所 有 例子 ,你 需要 一 个 编译 器 和 一 个 单元 测试 工具 。 有 些 例 子 会 用 到 第 
三 方程 序 库 。 下 面 将 概览 这 三 种 要 素 。 可 以 参见 第 1 章 进 一 步 了 解 细 闻 。 











单元 测试 工具 


在 众多 的 C++ 单元 测试 工具 中 , 我 选择 Google Mock ( 基于 Google Test ) 作为 书 中 大 部 分 例子 
的 工具 。 目前 来 说 , 它 是 关注 度 最 高 的 , 但 是 我 选择 它 的 主要 原因 是 , 它 支 持 Hamcrest 表 示 法 [一 
种 基于 匹配 器 (matcher ) 的 断言 形式 ， 用 以 提供 具备 较 强 表达 力 的 测试 ]。 第 1 章 提供 的 信息 将 帮 
助 你 快速 使 用 Google Mocks 

但 是 ， 本 书 既 不 是 Google Mock 的 专著 ， 也 不 是 其 宣传 手册 ， 而 是 教授 TDD 的 。 你 只 会 学 到 
足够 的 Google Mock 知 识 ， 用 以 有 效 地 实践 TDD。 


对 于 有 些 示 例 ， 还 需要 另外 一 个 单元 测试 工具 一 一 CppUTest。 如 果 没 有 使 用 过 Google Mock 
或 者 CppUTest， 也 大 可 放心 ， 因 为 你 会 发 现 学 习 另 外 一 个 单元 测试 工具 是 非常 容易 的 。 

信奉 你 正在 使 用 不 同 的 单元 测试 工具 ,诸如 CppUnit 或 者 Boost.Test， 也 不 用 担心 ! 这 些 工具 
和 Google Mock 在 概念 上 很 像 ， 在 实现 方式 上 也 类 似 。 你 可 以 轻松 跟 上 ， 并 且 几 乎 可 以 用 任何 其 
他 的 C++ 单元 测试 工具 来 做 TDD 的 例子 。 可 以 参见 附录 A， 了 解 在 选择 单元 测试 工具 时 什么 是 
重要 的 。 


本 书 中 的 大 部 分 例子 使 用 Google Mock 用 以 mocking 和 stubbing， 参 见 第 $ 章 。 当 然 ，Google 
Mock 和 Google Test 是 一 起 工作 的 ,但 是 也 能 将 Google Mock 成 功 地 集成 进 你 所 选 的 单元 测试 工具 。 
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编译 器 


需要 一 个 支持 C++11 标 准 的 编译 右 。 本 书 中 的 例子 最 初 是 使 用 gece 编译 的 ， 在 Linux 和 Mac OS 
上 可 以 直接 使 用 。 参见 第 1 章 获 取 如 何在 Windows 上 编译 的 信息 。 所 有 的 例子 都 使 用 了 STL, 它 是 
许多 平台 上 现代 C++ 开 发 中 的 基本 组 成 部 分 。 
























































第 三 方程 序 库 
一 些 例子 使 用 了 免费 的 第 三 方程 序 库 。 参 见 第 1 章 获 取 需 要 下 载 的 程序 库 列表 。 


怎样 使 用 本 书 
我 在 设计 本 书 章节 时 尽量 使 它们 功能 独立 ,你 可 以 随机 挑选 一 章 阅 读 ， 而 不 需要 依赖 其 他 章 

















节 。 如 果 使 用 电子 阅读 器 的 话 , 我 也 提供 了 充足 的 全 文 交 叉 索 引 , 可 方便 、 轻 松 地 在 章节 间 跳 转 。 
每 一 章 都 有 一 个 总 览 和 一 个 总 结 , 并 配 以 下 一 章 预 览 。 这 些 概要 性 小 节 的 名 称 , 与 许多 单元 测试 
框架 的 初始 化 代码 段 和 清理 代码 段 一 样 ， 取 名 为 Setup 和 Teardown'” 。 








源 代码 


本 书包 含 大 量 的 代码 示例 。 大 部 分 代码 与 一 个 特定 的 文件 名 联系 。 你 可 以 在 本 书 的 网 站 ”上 
找到 所 有 代码 : http://pragprog.com/book/lotdd/modern-c-programming-with-test-driven-development。 
或 者 访问 我 的 GitHub 主 页 : http:/gitbug.conyjlangr。 

示例 代码 按照 章节 组 织 。 在 每 一 章 的 目录 下 ， 有 很 多 以 数字 命名 的 目录 ,每 个 数字 对 应 一 个 
版 本 号 。 在 各 章 的 学 习 过 程 中 ， 我 们 会 引用 这 些 版 本 号 说 明代 码 的 演变 。 举 个 例子 ， 以 c2/7/ 
SoundexTest.cpp 为 标题 的 代码 ， 在 第 2 章 代 码 目录 下 第 7 个 版 本 目录 的 SoundexTest.cpp 文 件 中 。 








本 书 讨 论 

请 加 入 本 书 论 坛 : https://groups.google.com/forum/?fromgroups#!forum/modern-cpp-with-tdd。 
论坛 的 目的 是 讨论 书 中 内 容 ， 以 及 和 C++ 测试 驱动 开发 有 关 的 方面 。 我 也 会 发 布 一 些 和 本 书 相 关 
的 有 用 信息 。 





如 果 你 第 一 次 接触 测试 驱动 开发 : 本 书包 含 什么 


虽然 本 书 适 合 所 有 人 , 但 其 主要 受众 是 第 一 次 接触 TDD 的 程序 员 , 所 以 书 中 的 章节 安排 有 相 
应 的 先后 顺序 。 我 强烈 建议 你 完成 第 2 章 的 练习 。 完 成 这 样 一 个 示例 ， 你 会 对 TDD 背 后 的 思想 有 
深刻 的 领悟 。 切 忌 只 是 阅读 ， 要 尽量 动手 去 做 ， 并 保证 该 通过 的 测试 都 能 通过 。 

接 下 来 的 第 3 章 和 第 4 章 是 必 读 的 。 这 两 章 详 述 了 什么 是 TDD ( 和 什么 不 是 TDD ) 以 及 怎样 构 
建 测试 。 在 学 习 mock 之 前 〈 参 见 第 5 章 )， 务 必 保 证 理解 这 两 章 的 内 容 。mock 有 是 构建 大 多 数 产品 
级 系统 的 必 备 技术 。 

不 要 自 以 为 了 解 设 计 和 重 构 而 跳 过 第 6 章 。 上 戚 行 TDD 的 重要 原因 是 ， 它 使 你 在 通过 持续 重 构 
改进 设计 的 同时 ， 能 够 保持 代码 干净 整洁 。 大 部 分 系统 有 着 粳 糕 的 设计 和 上 涩 的 代码 ， 部 分 原因 
在 于 , 开发 者 不 愿意 做 足够 的 重 构 或 者 不 知道 怎么 去 做 。 你 将 学 到 足够 的 知识 ， 了 解 怎样 获 益 于 
一 个 更 小 、 更 简单 的 系统 。 

















































































































Q@ 一 般 而 言 ,每 个 测试 会 提供 Setup 和 Teardown 函 数 ， 用 于 测试 的 初始 化 和 清理 操作 。 作 者 特意 为 书 中 每 章 配备 这 一 
头 一 尾 两 小 节 ， 与 测试 框架 的 结构 相 呼 应 ， 颇 具 创 意 。 相 比 于 测试 代码 ， 为 了 便于 书面 阅读 ，Setup 和 Teardown 
在 文中 分 别 译作 “开场 白 ” 和 “结束 语 ”。 译 者 注 

© 本 书 在 图 灵 社 区 上 的 地 址 是 : http:/www.ituring.com.cn/book/1303。 一 一 编者 注 




































































第 7 童 将 总 结 TDD 的 核心 技巧 。 这 一 章 考察 了 许多 方法 , 它们 能 提高 你 在 TDD 上 投资 的 回报 。 


学 习 其 中 的 一 些 技巧 将 能 够 决定 TDD 成 功 与 否 。 
你 肯定 会 被 卷 人 一 场 与 已 有 系统 的 斗争 ， 而 这 个 已 有 系统 可 能 没有 使 月 
章 了 解 一 些 应 对 遗留 代码 的 简单 技术 。 
第 9 章 专 门 讨论 多 线程 下 的 TDD。TDD 方 法 或 许 会 让 你 眼前 一 亮 。 
第 10 章 将 深入 一 些 特 定 的 领域 和 关注 点 。 你 会 发 现 一 些 TDD 的 最 新 思路 , 包括 与 本 书 不 同 的 
一 些 方法 。 
最 后 , 你 想 知 道 怎样 使 你 的 团队 采用 TDD。 当 然 , 你 也 一 定 想 确保 持续 使 用 TDD。 第 11 章 会 


提供 一 些 你 想 要 收入 训 中 的 点 子 。 








有 TDD。 可 以 阅读 第 8 

















如 果 你 有 一 些 测 试 驱 动 开 发 经 验 
你 可 以 随机 阅读 各 个 音节， 但 也 会 发 现 许多 来 之 不 易 的 条 


ES 
H7 


EI 
U^ 


之 言 贯穿 全 书 。 


排版 约定 
书 中 会 穿 搬 一 些 长 度 不 一 的 代码 段 。 当 正文 引用 这 些 代 码 时 ， 将 使 用 下 面 的 约定 。 


口 类 名 和 测试 名 采用 大 驼峰 式 命名 法 ( UpperCamelCase )。 
a 其 他 的 代码 内 容 以 代码 字体 呈现 。 下 面 是 一 些 例 子 : 


m 函数 名 ( 显示 空 参数 表 ， 即 便 所 指 的 函数 有 一 个 或 多 个 参数 。 有 时 候 ， 我 称 成 员 函 数 
为 方法 ); 


变量 名 ; 


a 关键 字 ; 
m 其 他 代码 片段 。 
为 了 保持 简洁 并 节省 版 面 , 代码 清单 通常 会 省 略 与 当前 讨论 不 相干 的 代码 。 大 括号 后 的 注释 
代替 了 省 略 掉 的 代码 。 如 下 所 示 ，for 循 环 体 被 省 略 。 


for (inti = 0; i < count; i++) { 
// 
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关于 “我 们 ” 
本 书 是 我 们 之 间 进行 交流 的 载体 。 一 般 而 言 , 我 是 在 与 读者 谈话 。 当 我 特 指 “我 ”的 时 候 ( 不 
是 很 经 常 ) 通常 是 在 表述 经 验 之 谈 或 个 人 偏好 。 隐 含 之 意 是 ， 这 些 表 述 可 能 并 没有 被 广泛 接受 







































































z 
wh 
~ 





(虽然 有 可 能 是 个 好 想法 )。 


具体 到 编码 , 我 希望 不 是 你 一 个 人 在 做 , 原因 在 于 你 仍 在 努力 学 习 。 我 们 将 共同 完成 书 中 的 
编码 练习 。 


























关于 我 

我 从 1980 年 就 开始 编写 程序 了 ， 当 时 我 在 读 高 二 。 我 的 编程 职业 生涯 是 从 1982 年 开始 的 ， 当 
时 我 在 马里 兰 大 学 工作 ， 同 时 也 在 攻读 计算 机 科学 学 士 学 位 。2000 年 ,我 完成 了 从 程序 员 到 咨询 
顾问 的 角色 转变 ， 期 间 我 很 享受 为 Bob Martin 工 作 ， 以 及 偶尔 与 Object Mentor 的 优秀 人 才 一 起 工 
作 的 时 光 。 


2003 年 ， 我 创办 了 Langr Software Solutions， 提 供 敏 捷 开 发 相关 的 咨询 和 培训 服务 。 我 的 大 
部 分 工作 是 与 开发 者 一 起 实践 TDD ， 或 者 教授 TDD。 在 真实 的 开发 团队 中 ， 我 坚持 在 咨询 师 / 撞 
训 师 和 一 线程 序 员 两 种 角色 间 来 回 切换 ， 以 保证 自己 一 直 参 与 其 中 不 掉队 。 从 2002 年 起 , 我 作为 
全 职 程序 员 为 四 个 不 同 的 公司 工作 了 相当 长 一 段 时 间 。 

我 喜欢 从 事 软件 开发 方面 的 写作 。 这 是 我 深入 学 习 事物 的 一 种 方式 , 我 也 乐于 帮助 其 他 开发 
者 快速 编写 出 高 质量 代码 。 这 是 我 的 第 四 本 书 ， 其 他 三 本 是 Essential Java Style: Patterns for 
Implementation [Lan99] , Agile Java: Crafting Code With Test-Driven Development [Lan05 |flAgile in a 
Flash [OL11]， 其 中 最 后 一 本 是 与 Tim Ottinger 合 著 的 。 我 为 Bob 大 叔 的 《代码 整洁 之 道 》 撰 写 了 
几 章 。 除 了 我 自己 的 网 络 站 点 ,我 还 在 其 他 站 点 上 写 过 一 百 多 篇 文章 。 我 会 定期 更 新 自己 的 博客 
( http;//langrsoft.com/jeff )， 也 为 Agile in a Flash 项 目 (http:/agileinaflash.com ) 写 过 或 参与 写作 上 
百 篇 文章 。 

除了 C++， 我 们 还 使 用 过 许多 其 他 编程 语言 ， 如 Java、Smalltalk 、C 、C# 和 Pascal 等 。 目 前 ， 
我 在 学 习 Erlang， 也 能 够 使 用 Python 和 Ruby 进 行 编程 。 除 此 之 外 ， 我 学 习 过 至 少 十 几 种 编程 语言 
来 了 解 它们 (有 时 候 也 是 为 了 一 时 之 需 )。 





















































































































































本 书 中 的 C++ 代码 风格 


虽然 我 使 用 C++ 开发 过 各 种 规模 的 软件 系统 ， 但 我 并 不 认为 我 是 一 个 语言 专家 。 我 读 过 
Meyers 和 Sutter 的 一 些 重要 著作 ， 当 然 还 有 其 他 一 些 。 我 知道 怎样 让 C++ 代码 工作 ， 以 及 如 何 使 
代码 更 具 表 达 力 和 可 维护 性 。 我 知晓 这 种 语言 的 大 部 分 次 奥 的 用 法 , 却 尽 量 避 免 使 用 它们 。 我 在 
本 书 中 对 聪明 代码 的 定义 是 “难以 掌控 "。 我 会 引导 你 另 入 蹊 径 。 

我 写 C++ 代 码 的 风格 偏向 于 面向 对 象 ( 这 当然 是 受到 Smalltalk 、Java 和 C# 的 影响 ), 我 喜欢 大 
部 分 代码 以 类 的 方式 存在 。 本 书 中 大 部 分 代码 遵从 这 一 风格 。 例 如 第 一 个 示例 中 的 Soundex 就 是 
以 类 的 方式 构建 的 ( 参见 第 2 章 )， 当 然 不 是 必须 这 样 做 。 我 喜欢 这 种 方式 ， 如 果 你 不 喜欢 ， 可 以 





























用 自己 的 方式 来 实现 。 

TDD 的 价值 本 身 与 C++ 编程 风格 无 关 ,， 所 以 不 要 受 我 的 风格 影响 而 否定 其 潜力 。 过 多 强调 面 
向 对 象 有 助 于 对 测试 替身 〈 参 见 第 5 章 ) 的 理解 ， 这 个 时 候 需 要 拆除 难 缠 的 依赖 关系 。 如 果 置 身 
于 TDD 中 ， 时 间 和 久 了 或 许 会 让 你 的 编码 风格 向 面向 对 象 转 变 。 这 倒 不 是 坏事 ! 

我 有 点 懒 。 鉴 于 示例 规模 较 小 , 我 尽量 不 用 命名 空间 , 但 在 实际 的 产品 代码 中 我 一 定 会 使 用 它 。 

我 喜欢 尽量 保持 代码 精简 ,这样 会 避免 我 认为 的 视觉 混乱 。 因 此 在 大 部 分 实现 文件 中 , 你 会 
发 现 use namespace std; ,尽管 许多 人 认为 这 是 不 好 的 风格 。( 保持 类 和 函数 小 巧 且 功能 单一 , 比 * 所 
有 的 函数 应 该 有 唯一 的 返回 值 ”这 样 的 指南 更 有 用 。) 不 必 担 心 ，TDD 不 会 影响 你 坚持 自己 的 标 
准 ， 我 也 不 会 。 

最 后 关于 C++ 要 说 的 是 ， 这 门 语言 博大 精深 。 我 确信 有 更 好 的 方法 来 实现 本 书 中 的 示例 ， 而 
且 我 敢 肯 定 有 一 些 我 没 使 用 过 的 库 。 测 试 驱动 的 优点 是 ， 你 可 以 重新 以 多 种 方式 完成 一 个 实现 ， 





























































































































却 不 用 担心 损害 其 他 功能 。 无 论 如 何 ， 请 写 信 告 诉 我 一 些 改善 的 建议 ， 前 提 是 你 愿意 使 用 TDD 
的 方式 。 

















电子 版 。 
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1.4 开场 白 
搭建 开发 环境 是 任何 软件 开发 过 程 中 都 需要 劳 心 费力 的 事情 之 一 。 在 本 章 中 , 你 将 了 解 到 编 
译 和 执行 书 中 示例 所 需 的 工具 。 你 也 会 了 解 一 些 相关 的 提示 ， 以 避 开 我 走 过 的 弯路 。 


本 章 目 前 包含 Linux 和 Mac OS 下 的 环境 搭建 。 如 果 是 在 Windows 下 使 用 C++ 的 话 ， 可 以 参考 
1.3.3 节 提 到 的 建议 。 











1.2 示例 程序 


书 中 示例 的 源 代码 可 以 从 http://pragprog.com/titles/lotdd/source_code 下 载 。 每 章 的 示例 放 在 一 组 。 

从 TDD 中 学 习 的 许多 东西 都 涉及 增 量 地 开发 代码 , 所 以 每 章 的 示例 都 以 增 量 的 方式 给 出 。 
章 的 目录 下 以 数字 命名 的 子 目录 2 3-5 ) 对 应 相应 的 版 本 。 例 如 ， 第 2 章 中 的 第 一 段 代 码 
是 c2/1/SoundexTest.cpp， 它 表示 SoundexTest.cpp 的 第 一 个 版 本 。c2/2/SoundexTest.cpp 则 是 第 二 个 
版 本 。 


也 能 在 GitHub ( https://github.com/jlangr ) 上 找到 示例 程序 。 在 GitHub 上 ， 可 以 找到 对 应 本 书 
相关 章节 的 代码 库 。 例 如 ， 代 码 库 c2 对 应 本 书 第 2 章 的 Soundex 示 例 。 

本 书 中 示例 的 代码 版 本 号 对 应 GitHub 版 本 库 的 一 个 分 支 (branch )”。 例如 ， 可 以 在 代码 库 c5 
的 分 支 4 找到 c5/4/PlaceDescriptionService.cpp 所 对 应 的 代码 。 

在 每 个 版 本 的 目录 下 ,可 以 找到 源 代码 ,其 中 有 一 个 主 函 数 来 运行 所 有 的 测试 ,还 有 一 个 CMake 
编译 脚本 。 需 要 安装 和 配置 一 些 工具 来 运行 示例 程序 。 有 一 些 示例 需要 安装 额外 的 第 三 方 库 。 












































Q@ 对 于 没有 接触 过 GitHub 的 开发 者 ， 可 以 先 了 解 一 下 Git (参见 http://www.git-scem.com )， 它 是 一 个 分 布 式 的 版 本 管 
理工 具 。GitHub 提 供 的 代码 管理 正 是 基于 Git。 当 然 , 作者 只 是 提供 一 个 从 GitHub 上 下 载 示例 的 选项 ,理解 本 书 的 
内 容 并 不 需要 懂得 Git。 译 者 注 
























































你 需要 一 个 支持 C++11 标 准 的 编译 器 和 make" 来 编译 示例 代码 。 大 部 分 代码 需要 Google Mock 




















作为 单元 测试 工具 。 其 中 有 三 章 的 示例 使 用 CppUTest 作 为 单 


元 测试 工具 。 


























你 可 能 需要 修改 源码 包 来 支持 其 他 的 编译 器 〈 或 者 不 支持 C++l1 的 编译 器 )， 使 用 其 他 的 编 
译 工具 或 单元 测试 工具 。 所 幸 的 是 ， 除 了 第 7 章 的 库 代 码 ， 大 部 分 示例 都 比较 小 。 


下 面 的 表格 列举 了 每 章 对 应 的 目录 ， 以 及 所 需 的 单元 测 

















试 工具 和 第 三 方 库 。 














章节 名 称 目录 单元 测试 工具 第 三 方 库 
测试 驱动 开发 : 第 一 个 示例 c2 Google Mock 无 
测试 驱动 开发 基础 c3 Google Mock 无 
测试 结构 c4 Google Mock 无 
测试 替身 c5 Google Mock cURL, JsonCpp 
增 量 设计 c6 Google Mock Boost ( 格 列 高 利 历 ) 
高 质量 测试 c7 Google Mock Boost ( 格 列 高 利 历 、 算 法 、 赋 值 ) 
遗留 代码 的 挑战 wav CppUTest Hog, Boost (文件 系统 ) 
测试 驱动 开发 与 多 线程 c9 CppUTest X 
测试 驱动 开发 的 其 他 概念 和 讨论 tpp CppUTest X 
代码 Kata:， 罗马 数字 转换 器 roman Google Mock X 


1.3 ”C++ 编译 器 


1.3.1 Ubuntu 
最 初 在 Ubuntu 12.10 上 使 用 g++4.7.2 构 建 书 中 的 示例 。 
可 以 通过 下 面 的 命令 安装 g++: 


sudo apt-get install build-essential 


























1.3.2 OS X 


我 在 Mac OS X 10.8.3 ( Mountain Lion ) 上 用 gcc port 成 





功 构 建 了 书 中 的 示例 。 在 撰写 本 书 的 


时 候 ， 随 Xcode 发 布 的 gcc 版 本 是 4.2， 这 个 版 本 并 不 能 构建 书 中 的 示例 。 
为 了 安装 gcc port， 需 要 安装 MacPorts， 它 允许 你 在 Mac 上 安装 免费 软件 。 参 见 http://www. 


macports.org/install.php 获 得 更 多 的 信息 。 
安装 好 后 ， 需 要 使 用 以 下 命令 更 新 MacPorts: 


sudo port selfupdate 
































(D make 是 用 来 完成 自动 编译 的 工具 ， 参 见 https://en.wikipedia.org/wiki/GNU_make。 




















使 用 下 面 的 命令 安装 gcc port ( 安装 可 能 需要 较 长 的 时 间 ): 


sudo port install gcc47 





( 如果 你 喜欢 , 可 以 在 命令 后 追加 +uniersatL 选 项 , 这 样 就 可 以 同时 为 PowerPC 和 Intel 架 构 生 





成 程序 。) 





在 成 功 安装 好 gcc port 后 ， 需 要 指定 其 为 默认 的 gcc。 可 以 使 用 下 面 的 命令 : 


sudo port select gcc mp-gcc47 


可 以 使 用 下 面 的 命令 将 gcc 加 入 路 径 名 称 列表 : 


hash gcc 


1.3.3 Windows 





在 Windows 操 作 系 统 上 ， 要 保证 代码 的 行为 和 预期 一 样 ， 可 以 考虑 使 用 MinGW 或 Cygwin 中 


的 g++ port。 你 可 以 尝试 Microsoft Visual C++ 编译 器 2012 年 11 月 的 CTP 版 

















和 Clang， 但 是 截至 本 书 


写作 时 ， 它 们 都 还 不 能 完整 地 支持 C++11 标 准 。 本 节 将 简要 描述 一 下 在 Windows 下 运行 本 书 示例 


的 一 些 困 难 和 建议 。 
1. Visual C++ 编译 器 2012 年 11 月 CTP 版 


可 以 下 载 Visual C++11 编 译 器 的 社区 科技 预览 (CTP ) 版 ? Visual 
篇 描述 相关 版 本 的 文章 。 


快速 地 看 一 下 开发 本 书 示例 使 用 的 CTP 版 可 以 很 快 地 了 解 如 下 几 件 引 
口 目前 还 没完 全 支持 类 内 成 员 初 始 化 。 











std::unordered map 也 没 实现 。 











C++ 团队 的 博客 ”上 有 一 


Er 
o 





O std 库 对 于 C++1l1 的 支持 似乎 是 最 大 的 短 板 。 例 如 ， 集 合 类 目前 还 不 支持 统一 初始 化 列表 。 


O Google Mock/Google Test 使 用 了 可 变 参数 模板 , 这 还 没 得 到 完全 支持 。 在 构建 Google Mock 


时 ， 你 会 收 到 编译 错误 信息 。 你 需要 为 这 些 工程 项 目 加 一 个 预 处 理 宏 定义 VARIADIC —-. 














MAX, ， 并 将 其 设置 为 10。 可 以 参见 http://stackoverflow.com/qu 
test-in-visual-studio-2012 获 取 更 多 的 信息 。 


2. Windows 示 例 代 码 





estions/12558327/google- 


在 本 书 即将 付 梓 之 际 ,我们 正在 创建 能 够 在 Windows 上 运行 的 示例 (通过 移 除 一 些 不 支持 的 











(D http://www.microsoft.com/en-us/download/details.aspx?id-35515 ( 本 书写 于 2012 年 ， 作 者 当时 使 用 的 Visual C++ 比较 
旧 。 最 新 的 Visual Studio 2015 完 全 支持 C++ll 标 准 。 为 了 得 到 最 新 的 Visual Studio， 读 者 可 以 访问 https://www. 
visualstudio.com/。 原 书 给 出 的 Visual C++ 编译 器 2012 CTP 链 接 因 意 义 不 大 ， 故 此 处 略 去 。 一 一 译 者 注 ) 

@ http://blogs.msdn.com/b/vcblog/archive/2012/11/02/visual-c-c-11-and-the-future-of-c.aspx 
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C++11 特 性 )。 可 以 在 一 个 单独 的 GitHub 页 面 (https://github.com/jlangr ) 上 找到 修改 过 的 示例 ， 
这 也 是 一 章 一 个 代码 库 。 可 以 访问 Google 讨 论 组 (https://groups.google.com/forum/?from- 
groups#!forum/modern-cpp-with-tdd ) 获得 更 多 Windows 示 例 的 信息 。 


Windows 版 的 代码 库 包含 解决 方案 (.sln ) 和 项 目 ( .vcxproj ) 文 件 。 可 以 使 用 这 些 文件 在 Visual 
Studio Express 2012 中 加 载 示 例 代 码 ， 也 可 以 在 命令 行 中 使 用 MSBuild 编 译 和 运行 示例 。 

如 果 要 自己 修改 代码 ， 应 该 不 是 那么 困难 。 去 掉 类 外 的 初始 化 应 该 比较 容易 。 可 以 使 用 
std::map 取 代 std::unordered_map。 许多 加 入 到 C++11 中 的 特性 来 自 boost::trl 库 , 所 以 你 可 以 直接 替 
换 掉 Boost 库 的 实现 。 

3. 一 些 Windows 小 技巧 


对 于 编译 警告 、 错 误 和 一 些 其 他 导致 不 能 编译 的 问题 ,我 在 网 上 进行 了 相关 搜索 。 下 面 是 我 
学 到 的 一 些 东西 。 















































着 误 /问题 解决 方案 
C297: 'std:tuple': too many template ”添加 预 处 理 器 定义 VARIADIC MAX-10, 参考 http://stackoverflow.com/ questions/ 
arguments. 82774588/c2977-stdtuple-too-many-template-arguments-msvc11 


Specified platform toolset (v110) is — ji E VisualStudioVersion25 11.0 
not installed or invalid. 


msbuild.exe 在 哪里 我 机 器 上 的 msbuild.exe 是 在 c:\Windows\Microsoft.NET\Framework\v4.0.30319 里 


Warning C4996: 'std:: Copy impl: -D_ SCL SECURE NO WARNINGS 
Function call with parameters that 
may be unsafe. 


按 Ctrl-F5 运 行 测 试 结束 后 ,控制 台 ” 设 置 Configuration Properties 一 Linker 一 System 一 SubSystem 为 Console 
窗口 关闭 (/SUBSYSTEM:CONSOLE) 


Visual Studio 党 试 链接 仅 存 在 于 头 “ 添加 BOOST_ALL NO_LIB 预 处 理 器 
许多 问题 的 解决 方案 已 经 包含 在 项 目 文件 中 了 。 
4. Visual Studio 2013 预 览 


就 在 本 书 最 后 修订 的 时 候 ， 微 软 发 布 了 Visual Studio 2013 预 览 版 ， 它 提供 了 C++11 标 准 特性 
的 进一步 支持 ， 同 时 还 支持 了 C++14 预 案 特 性 。 短 期 内 ，GitHub 上 的 Windows 代 码 可 以 在 2012 年 
11 月 的 CTP 版 上 上 运行。 我 们 (我 自己 和 一 些 提 供 帮 助 的 人 ) 已 经 使 用 了 Visual Studio 2013 ， 过 不 
了 多 久 ， 你 就 能 下 载 到 使 用 了 更 多 C++11 特 性 的 升级 版 本 。 我 希望 最 终 不 需要 为 Windows 提 供 专 
用 版 本 的 示例 代码 。 这 是 一 个 符合 C++11 标 准 的 Windows 版 编译 器 ! 
























































1.4 CMake 


无 论 好 坏 ， 我 选择 CMake 来 支持 跨 平台 编译 。 
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对 于 Ubuntu 用 户 ， 本 书 使 用 CMake 2.8.9 编 译 示 例 。 可 以 通过 下 面 的 命令 安装 CMake: 


sudo apt-get install cmake 















































对 于 OS X 用 户 ， 本 书 使 用 CMake 2.8.10.2 编 译 示 例 。 可 以 访问 http://www.cmake.org/cmake/ 
resources/software.html， 下 载 安 装 CMake。 


当 使 用 CMake 来 运行 编译 脚本 时 ， 可 能 会 遇 到 下 面 的 错误 : 


Make Error: your CXX compiler: "CMAKE CXX COMPILER-NOTFOUND" was not found. 
Please set CMAKE CXX COMPILER to a valid compiler path or name. 











这 个 信息 提示 没有 找到 合适 的 编译 器 。 如 果 只 是 安装 了 gcc 而 不 是 g++， 就 可 能 遇 到 这 样 的 错 
误 。 在 Ubuntu 上 ， 安 装 build-essential 可 以 解决 这 个 问题 。 在 OS X 上 ， 定 义 或 者 修改 CXX 可 以 解 
决 这 个 问题 。 

export CC-/opt/local/bin/x86 64-apple-darwinl2-gcc-4.7.2 

export CXX-/opt/local/bin/x86 64-apple-darwin-12-g-*-mp-4.7 











1.5 Google Mock 


本 书 许多 示例 都 使 用 了 Google Mock， 它 是 一 种 模拟 (mock) 和 匹配 器 框架 ， 其 中 包含 了 单 
元 测试 工具 Google Test。 我 在 书 中 会 交替 使 用 这 两 个 术语 ， 但 是 大 部 分 时 候 会 使 用 Google Mock 
以 保持 简单 。 你 可 能 需要 阅读 Google Test 文 档 来 理解 我 提 到 的 Google Mock 特 性 。 


需要 把 Google Mock 链 接 到 示例 中 , 这 意味 着 必须 先 编译 Google Mock 库 。 下 面 的 步骤 或 许 能 
帮 到 你 。 也 可 以 参考 Google Mock 附 带 的 README.txt 文 件 来 了 解 更 详细 的 安装 步 又: https://code. 
google.com/p/googlemock/source/browse/trunk/README , 












































1.5.1 安装 Google Mock 

















Google Mock 的 官方 网 站 是 : https://code/google.com/p/googlemock/, n] LJ http://code/google. 
com/p/googlemock/downloads/list 下 载 Google Mock。 本 书 示 例 使 用 的 是 Google Mock 1.6.0。 


解压 安装 包 ( 例如 ，gmock-1.6.0.zip ), 或许 在 home 目 录 下 。 
创建 环境 变量 GMOCK_HOME 指 向 该 目录 ， 例 如: 





export GMOCK HOME-/home/jeff/gmock-1.6.0 


Windows 系 统 上 使 用 下 面 的 命令 : 


setx GMOCK HOME c:\Users\jlangr\gmock-1.6.0 





1. Unix 








对 于 Unix 用 户 ， 如 果 你 想 跳 过 README 里 的 编译 步骤 ， 也 可 以 使 用 下 面 的 步骤 成 功 编译 。 








— 




















我 选择 CMake 来 编译 Google Mock, TEGoogle Mock 安 装 根 目录 下 ( HI$GMOCK. HOME ), 执行 下 























列 步骤 : 


mkdir mybuild 
cd mybuild 
cmake .. 

make 



































E 











使 用 其 他 名 字 ， 需 要 改动 所 有 的 CMakeLists.txt 文 件 。 
你 也 需要 编译 Google Test， 它 包含 在 Google Mock 里 。 


cd $GMOCK HOME/gtest 
mkdir mybuild 

cd mybuild 

cmake .. 

make 


2. Windows 





译 目录 的 名 字 为 mybuild， 这 是 随意 的 。 但 是 本 书 示例 的 编译 脚本 都 使 用 这 个 名 字 。 如 


FH 
IN 





在 Google Mock 发 布 包 里 , 可 以 找到 msvc\2010\gmock.sIn 文 件 , 这 个 应 该 适用 于 Visual Studio 
2010 和 更 新 的 版 本 。( 也 可 以 找到 .msvc\2005.gmock.sln， 它 适用 于 Visual Studio 2005 和 Visual 





Studio 2008, ) 








为 了 能 使 用 Visual Studio 2010 和 Visual Studio 2012 编 译 Google Mock， 需 要 配置 项 目 使 用 2012 
年 11 月 的 CTP 版 。 从 项 目 属性 开始 ， 导 航 至 Configuration Properties->General->Platform Toolset, 























然后 选择 CTP。 


CTP 版 不 支持 可 变 参 数 模板 ( Visual Studio 2013 或 许可 以 )。 所 以 我 们 来 模拟 它 。" 需 要 添加 





一 个 预 处 理 定义 VARIADIC_MAX， 使 其 高 于 默认 值 S。 定 义 成 10 应 该 可 行 。 


使 用 Google Mock 创 建 项 目 时 ， 需 要 指定 正确 的 头 文件 ， 包 含 目 录 和 库 文件 。 导 航 至 





H 


Configuration Properties->VC++ Directories， 做 下 面 几 件 事 情 。 





口 添加 $(GMOCK HOME)msvc\2010\Debug 到 Library Directories。 
口 添加 $(GMOCK HOME 和 include 到 Include Directories。 
口 添加 ($GMOCK HOME)\gtestinclude 到 Include Directores。 





导航 至 Linker->Input， 添 加 gmock.lib 到 Additional Dependencies。 
要 确保 Google Mock 和 项 目 使 用 相同 的 内 存 模型 。Google Mock 默 认 使 用 /MTd。 











(D http://stackoverflow.com/questions/12558327/google-test-in-visual-studio-2012 
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1.5.2 创建 main 函数 运行 Google Mock 测试 ET 
本 书 每 个 示例 的 代码 都 有 一 个 main.cpp 文 件 ， 专 门 与 Google Mock 配 合 使 用 。 











c2/1/main.cpp 

#include "gmock/gmock.h" 

int main(int argc, char** argv) ( 
testing::InitGoogleMock(&argc, argv); 


return RUN ALL TESTS(); 
} 


代码 中 的 main() 函数 首先 初始 化 Google Mock， 把 命令 行 的 参数 传 给 它 ， 然 后 运行 所 有 的 
测试 。 
大 多 数 时 候 ，main() 函数 只 需要 这 些 。Google Mock 也 提供 了 一个 默认 的 main() 函数 实现 


供 你 使 用 。 参 见 http://code.google.com/p/googletest/wiki/Primer#Wrting the main() _ Function 获得 
更 多 信息 。 














1.6 CppUTest 


除了 Google Test/Google Mock， 也 可 以 选择 CppUTest 作 为 单元 测试 框架 。CppUTest 提 供 许多 
同样 的 特性 ， 此 外 它 还 有 一 个 内 置 的 内 存 泄漏 监测 器 。James Grenning 的 《测试 驱动 的 能 入 式 C 
语言 开发 》 一 书 中 提供 了 更 多 的 示例 。 











1.6.1 安装 CppUTest 











(注意; 这 里 的 步骤 适用 于 CppUTest 3.3。 包 含 大 量 改动 的 最 新 版 本 3.4， 在 本 书 截稿 时 才 发 
布 ， 所 以 本 书 并 没有 使 用 这 一 版 。 ) 


CppUTest 的 项 目 主 页 是 http://www.cpputest.org/, 可 以 从 http://cpputest.github.io/cpputest/ 人 下载。 
下 载 好 文件 ， 解 压 至 home 目 录 下 的 新 目录 ， 如 pputest。 


创建 环境 变量 CPPUTEST HOME。 如 下 : 














export CPPUTEST HOME=/home/jeff/cpputest 


可 以 用 make 构 建 CppUTest。 如 果 需 要 模拟 支持 ， 需 要 构建 CppUTestExt。 


cd $CPPUTEST HOME 
./configure 

make 

make -f Makefile CppUTestExt 








可 以 使 用 make install 将 CppUTest 安 装 至 /usr/local/lib 下 。 











也 可 以 通过 CMake 来 构建 CppUTest。 




















如 果 使 用 Windows， 也 可 以 找到 一 些 使 用 MSBuild 的 批 处 理 文件 
和 2010。 





， 适 用 于 Visual Studio 2008 


1.6.2 ”创建 main 函数 以 运行 CppUTest 测试 


本 书 示例 WAV Reader 中 的 代码 包含 





一 个 testmain.cpp 文 件 ， 与 CppUTest 配 合 使 用 。 
wav/1/testmain.cpp 
#include "CppUTest/CommandLineTestRunner.h" 


int main(int argc, char** argv) ( 


return CommandLineTestRunner::RunAllTests(argc, argv); 


} 


1.7 libcurl 





libcurl 提 供 了 客户 端 URL 传 输 库 ， 它 支持 HTTP 和 其 他 许多 协议 。 它 还 支持 cURL 命 令 行 传输 
工具 。 在 本 书 中 ， 用 cURL 指 代 这 个 库 。 

















cURL 的 项 目 主 页 是 http://curl.haxx.se/， 可 以 从 http://curl.haxx.se/download.html 下 载 。 下 载 文 
件 后 ,解压 至 home 目 录 下 。 创 建 环境 变 量 CURL _HOME， 如 下 : 


export CURL HOME=/home/jeff/curl-7.29.0 


可 以 使 用 CMake 构 建 这 个 库 ， 如 下 : 


cd $CURL HOME 
mkdir build 
cd build 
cmake .. 

make 











1.8 JsonCpp 


JsonCpp 提 供 了 数据 交换 格式 支持 ， 如 JavaScript Object Notation ( JSON )。 


JsonCpp 的 项 目 主页 是 http:Wjsoncpp.sourceforge.net ， 可 以 从 http:/sourceforge.net/projects/ 
jsoncppy/files/ 下 载 。 下 载 文件 后 ， 解 压 至 home 目 录 下 。 创 建 环 境 变 量 JSONCPP_ HOME, WF: 


export JSONCPP HOME-/home/jeff/jsoncpp-src-0.5.0 

















JsonCpp 需 要 Scons， 这 是 一 个 基于 Python 的 构建 系统 。 在 Ubuntu 下 ， 使 用 下 面 的 命令 安装 
Scons: 
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sudo apt-get install scons 

切换 到 $JSONCPP_HOME 所 指 的 目录 ， 然 后 使 用 Scons 构 建 库 。 
scons platform-linux-gcc 

在 OS X 下 ， 用 Linux-gcc 作 为 平台 选项 在 我 的 系统 上 工作 。 


在 我 的 系统 上 ， 构 建 JonCpp 会 生成 SJSONCPP_ HOME/libs/linux-gcc-4.7/libjson linux-gec- 
4.7_libmt.a。 可 以 创建 一 个 符号 链接 指向 这 个 文件 ， 如 下 : 


cd $JSONCPP HOME/libs/linux-gcc-4.7 
ln -s libjson linux-gcc-4.7 libmt.a libjson linux-gcc-4.7.a 





1.9 rlog 





rlog 为 C++ 提供 消息 日 志 机 制 。 


rlog 的 项 目 主 页 是 http:/code.google.com/pmlog/。 下 载 文件 后 ,解压 至 home 目 录 下 。 创 建 环境 
变量 RLOG_HOME， 如 下 : 























export RLOG HOME-/home/jeff/rlog-1.4 


在 Ubuntu 下 ， 可 以 使 用 下 面 的 命令 构建 rlog 库 : 


cd $RLOG HOME 
./configure 
make 


在 OS X 下 ， 只 有 在 打上 一 个 补丁 (patch ) 后 才能 编译 rlog。 参 见 https://code.google.come/p/ 
rlog/issues/details?id=7 获 得 更 多 的 信息 , 以 及 补丁 代码 。 我 使 用 了 第 三 条 评论 ( This smaller diff... ) 
中 提 及 的 代码 。 也 可 以 在 源 代码 发 布 包 中 找到 这 个 补丁 代码 Ccode/wav/l/rlog.diff ). 


可 以 使 用 下 面 的 命令 打 补 本 和 构建 rog: 


cd $RLOG HOME 

patch -pl [path to file]/rlog.diff 
autoreconf 

./configure 

cp /opt/local/bin/glibtool libtool 
make 

sudo make install 


configure 命 令 会 复制 一 个 名 为 libtool 的 二 进 制 文件 到 rlog 目 录 ， 但 它 不 是 rlog 想 要 的 。cp 命 令 
行 所 做 的 是 复制 glibtool 覆 盖 libtool， 来 修复 这 个 问题 

如 果 这 个 补丁 不 能 工作 , 可 以 尝试 手动 修改 。 在 SRLOG _ HOME/rlog/common.h.in 文 件 中 , 有 

一 行 : 


# define RLOG SECTION attribute ((section("RLOG DATA"))) 


















































用 下 面 的 代码 奉 代 这 一 行 : 


#ifdef APPLE 

# define RLOG SECTION | attribute ((section(" DATA, RLOG DATA") )) 
#else 

# define RLOG SECTION . attribute ((section("RLOG DATA") )) 

#endif 


如 果 在 构建 rog 时 还 是 遇 到 问题 ( 这 在 Mac OS 和 Windows 上 的 确 非 常 困难 )， 不 要 担心 。 在 
完成 遗留 代码 示例 时 ， 跳 至 8.9 节 ， 学 习 怎 样 把 riog 彻 底 从 混乱 中 解救 出 来 。 


1.10 Boost 


Boost 提 供 了 大 量 的 C++ 基础 库 。 


Boost 的 项 目 主页 是 http://www.boost.org， 可 以 从 http://sourceforge.net/projects/boost/files/boost 
下 载 。Boost 会 定期 更 新 版 本 。 下 载 文件 ， 解 压 至 home 目 录 下 。 创 建 环境 变量 BOOST HOME 和 
BOOST VERSION， 如 下 : 




















export BOOST ROOT=/home/jeff/boost 1 53 0 
export BOOST VERSION-1.53.0 


许多 Boost 库 只 需要 头 文 件 。 实 现下 面 的 步 又 , 可 以 构建 所 有 使 用 Boost 的 示例 , 除了 第 8 章 中 
的 示例 。 
为 了 构建 第 8 章 中 的 代码 ， 需 要 构建 和 链接 到 Boost 中 的 库 。 我 使 用 下 面 的 命令 来 构建 相应 
的 库 : 


cd $BOOST ROOT 
./bootstrap.sh --with-libraries=filesystem,system 
./b2 


这 里 使 用 的 命令 应 该 可 以 工作 ， 如 果 不 能 的 话 ， 请 参见 http:/ubuntuforums.org/ showthread. 
php?t1180792 (注意 ，bootstrap.sh 该 是 --with-libraries )。 























1.11. 构建 示例 并 运行 测试 


安装 好 所 需 的 软件 后 ， 就 能 构建 所 有 版 本 的 示例 ， 接 下 来 就 可 以 运行 测试 。 在 一 个 示例 的 版 
本 目录 下 ， 首 先 需 要 使 用 CMake 创 建 一 个 makefile: 


mkdir build 

cd build 

cmake .. 

遗留 代码 示例 (参见 第 8 章 ) 使 用 Boost 中 的 一 些 库 ， 不 仅仅 是 头 文件 。CMakeLists.txt 使 用 
BOOST ROOT 环境 变量 。 原因 有 二 : 首先 , 通过 include directories 指 明 , 在 哪里 能 找到 Boost 
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头 文件 ; 其 次 ，CMake 通 过 执行 find_package 定 位 Boost 库 。 

在 构建 遗留 代码 示例 的 时 候 ， 可 能 会 遇 到 错误 ， 表 明 找 不 到 Boost。 此 时 ， 可 以 尝试 在 执行 
CMake 时 传人 BOOST BOOT 改变 位 置 ， 如 下 : 

cmake -DBOOST ROOT-/home/jeff/boost 1 53 0 .. 

和 否则， 确保 Boost 库 已 经 被 正确 构建 。 

一 旦 使 用 CMake 创 建 完 makefile 后 ， 就 可 以 切换 到 示例 的 build 目 录 ， 执 行 下 面 的 命令 构建 示 











例 : 
make 
为 了 执行 测试 ， 切 换 到 示例 的 build 目 录 ， 使 用 下 面 的 命令 执行 : 
./test 


对 于 第 7 章 中 的 库 示 例 ， 可 以 在 build/library/Tests 目 录 下 找到 测试 执行 文件 。 


1.12 结束语 


在 本 章 中 , 你 学 习 了 构建 和 运行 本 书 示例 需要 做 的 事情 。 记 住 , 最 好 的 学 习 方式 就 是 跟随 示 
例 ， 动 手 去 做 。 

如 果 在 配置 的 时 候 遇 到 了 困难 , 首先 向 可 信 的 同伴 寻求 帮助 。 多 一 双眼 睛 可 以 快速 发 现 已 困 
扰 你 一 段 时 间 的 问题 。 可 以 访问 本 书 的 主页 http://pragprog.comytitles/lotdd ， 找 到 有 帮助 的 提示 , 
或 者 去 论坛 讨论 。 如 果 你 和 同伴 都 被 难 住 了 ， 请 给 我 发 电子 邮件 吧 ! 














测试 驱动 开发 : 第 一 个 示例 








2.1 ”开场白 

写 个 测试 ,保证 它 通 过 , 接着 重 构 设 计 。 这 就 是 TDD 的 全 部 内 容 。 但 是 这 三 个 简单 步 又 的 背 
后 却 另 有 乾坤 。 理 解 怎 样 利 用 TDD 将 使 你 受益 菲 浅 。 俗 话说 “前 车 之 鉴 ， 后 事 之 师 ”， 如 果 缺 乏 
前 人 的 经 验 ， 你 也 很 有 可 能 放弃 TDD。 

与 其 让 你 在 学 习 中 趣 起 前 行 , 我 更 愿意 带领 你 以 测试 驱动 的 方法 开发 一 些 代 码 , 这 将 帮助 你 
理解 每 一 步 背后 的 故事 。 在 本 章 中 , 最 好 的 学 习 方 法 就 是 跟着 示例 一 起 做 。 当 然 首 先 要 确保 开发 
环境 已 设置 好 ( 参见 第 1 章 )。 
虽然 书 中 示例 规模 不 大 ， 但 也 绝 非 一 点 用 没有 或 毫 无 价值 ( 当然 也 不 是 什么 高 科技 )。 这 些 
示例 提供 了 许多 教学 点 ， 展 示 了 TDD 怎 样 帮助 你 增 量 地 设计 一 个 算法 。 

好 了 ， 希望 你 已 经 准备 好 编写 代码 了 1 















































2.2 Soundex 类 


在 许多 应 用 程序 中 , 搜索 是 很 常见 的 功能 。 一 次 有 效 的 搜索 应 该 找 出 匹配 的 结果 ， 即 便 用 户 
的 输入 有 拼写 错误 。 许 多 人 就 曾 以 各 种 奇 昔 的 方式 拼 错 了 我 的 名 字 :Langer、Lang、Langur Lange, 
Lutefish 就 是 其 中 一 些 。 不 管 怎样 ， 还 是 希望 他 们 能 够 找到 我 。 

本 章 将 以 TDD 方 法 开发 Soundex 类 ， 该 类 能 提升 应 用 程序 的 搜索 能 力 。 这 个 算法 是 将 单词 编 
码 为 一 个 字母 和 三 个 数字 ， 它 将 发 音 相似 的 单词 映射 到 相同 的 编码 。 下 面 是 维基 百科 上 关于 
Soundex 规 则 的 描述 。?” 

(1) 保留 第 一 个 字母 。 丢 掉 所 有 出 现 的 a、e、 i、o、u、 y、h、w。 

(2) 以 数字 来 代替 辅音 ( 第 一 个 字母 除外 ): 










































































(D http://en.wikipedia.org/wiki/Soundex 
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Ub, f.p. v:1 
Qc.g.j.k.q.s. x. z:2 
QI d, t:3 

11:4 

Qm, n:5 

Dr:6 


(3) 如 果 相 邻 字 母 编码 相同 ， 用 一 个 数字 表示 它们 即 可 。 同 样 ， 如 果 出 现 两 个 编码 相同 的 字 
母 ， 且 它们 被 h 或 w 隔 开 ， 也 这 样 处 理 ; 但 如 果 被 元 音 隔 开 ， 就 要 编码 两 次 。 这 条 规则 同样 适用 
于 第 一 个 字母 。 

(4) 当 得 到 一 个 字母 和 三 个 数字 时 ， 停 止 处 理 。 如 果 需 要 ， 补 零 以 对 齐 。 






























































2.3 ”开始 吧 

关于 TDD 的 一 个 常见 误解 是 , 在 实现 产品 代码 前 先 定义 好 所 有 的 测试 。 事 实 正 好 相反 ,每 次 
你 只 需要 关注 一 个 测试 ， 此 后 逐渐 考虑 下 一 个 加 入 到 系统 中 的 行为 。 

TDD 的 一 般 方 法 是 逐步 实现 下 一 个 最 简单 的 规则 ( 想 要 了 解 特定 的 形式 化 方法 ， 请 参考 10.4 
节 )。 哪 个 有 用 行为 的 实现 最 直接 且 需 要 最 少 的 代码 改动 ? 

基于 这 一 思路 ， 要 从 哪里 开始 实现 Soundex 呢 ? 让 我 们 快速 推 想 一 下 实现 每 个 规则 都 需要 做 
些 什么 。 

规则 3 似乎 是 最 常用 到 的 。 规 则 4 指示 何 时 停止 编码 , 这 条 规则 应 该 只 在 其 他 规则 生成 编码 时 
才 会 用 到 。 规 则 2 暗示 第 一 个 字母 已 经 处 理 完毕 ， 所 以 从 规则 1 着 手 。 它 似乎 比较 直接 。 

规则 1 告诉 我 们 ， 保 留 名 字 的 第 一 个 字母 ， 然 后 …… 停止 ! 让 我 们 尽 可 能 地 保持 寻 
如 果 一 个 单词 中 只 有 一 个 字母 呢 ? 为 此 写 个 测试 。 


































































































情 简 单 。 


D 





c2/1/SoundexTest.cpp 


Line 1 Zinclude "gmock/gmock.h" 
2 TEST(SoundexEncoding, RetainSoleLetterOfOneletterWord) (1 
3 Soundex soundex; 


4j 


测试 列表 
在 TDD 过 程 中 ， 你 编写 并 通过 的 每 一 个 测试 ， 都 代表 新 加 入 到 系统 中 的 一 种 行为 。 除 了 完 
成 整个 功能 外 , 通过 的 测试 数目 是 衡量 进度 的 最 佳 指标 。 每 个 测试 都 代表 系统 中 一 个 小 的 行为 。 


虽然 不 能 事先 知晓 所 有 需要 编写 的 测试 ， 但 需要 对 将 要 处 理 的 事务 有 一 些 初步 的 认识 。 
许多 使 用 TDD 方 法 的 开发 者 将 他 们 想到 的 测试 记录 到 测试 列表 中 (测试 列表 在 Test Driven 
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Development: By Example [Bec02] 中 首次 提出 )。 这 个 列表 包含 测试 的 名 称 ， 或 在 需要 做 代码 
清理 时 提示 。 

可 以 把 测试 列表 写 在 工作 台 边 上 的 写字 板 上 (也 可 以 把 它 作为 注释 写 入 测试 文件 ， 只 要 
在 提交 代码 前 删 摔 就 行 ) 这 个 列表 仅 属于 你 自己 ， 所 以 如 果 喜 欢 的 话 ， 大 可 以 使 用 简要 或 
隐隐 的 表达 方式 。 

在 做 测试 驱动 开发 并 思考 新 的 测试 用 例 时 , 记得 把 它们 加 到 测试 列表 里 。 当 添加 一 些 你 
认为 将 来 需要 清理 的 代码 时 ,也 在 这 个 列表 中 加 一 个 提醒 项 。 在 完成 一 个 测试 或 任务 时 ,把 
它 从 列表 中 删除 即 可 ， 就 这 么 简单 。 如 果 在 编码 结束 后 ,发现 仍 有 没完 成 的 任务 项 ， 可 以 把 
它们 加 入 到 下 一 个 编码 阶段 的 列表 。 

可 以 把 测试 列表 作为 初始 设计 的 一 部 分 。 它 能 帮助 说 明 你 认为 自己 需要 构建 什么 
可 以 启发 你 去 思考 其 他 需要 做 的 事情 。 

不 要 被 这 个 列表 束缚 ， 它 决定 不 了 你 要 做 什么 ， 也 决定 不 了 你 做 事 的 顺序 。 但 是 ，TDD 
是 一 个 自然 的 流程 ， 通 常 要 顺 着 测试 指引 的 方向 去 做 下 一 件 事 。 

在 学 习 TDD 时 ， 管 理 测试 列表 非常 管用 。 试 一 试 吧 ! 





a 第 1 行 代码 中 包含 了 gmock 头 文件 ， 它 具备 写 一 个 测试 所 需 的 全 部 功能 。 

一 个 简单 的 测试 声明 需要 使 用 TEST 宏 C 第 2 行 代码 所 示 )。TEST 宏 有 两 个 参数 : 测试 用 例 
"Es 称 和 测试 的 描述 性 名 称 。 根 据 Google 的 文档 ， 测 试用 例 ( test case) 是 一 些 能 共享 数 
据 和 子 程序 的 测试 集合 。”( 这 个 术语 在 这 里 被 复 用 了 ， 对 于 有 些 人 而 言 ， 一 个 测试 用 例 
代表 一 种 情境 。” ) 

从 左 到 右 阅 读 测试 用 例 名 称 和 测试 名 称 ， 可 以 连 成 一 句 话 ， 描 述 了 我 们 想 要 验证 的 行为 : 
Soundex encoding retains [the] sole letter of [a] one-letter word。 因 为 还 要 为 Soundex 编 码 行 
为 写 其 他 测试 ， 所 以 用 SoundexEncoding 作 为 测试 用 例 名 字 ， 以 帮助 组 织 相关 测试 。 

不 要 低 佑 好 的 测试 名 称 的 重要 性 。 如 下 所 示 。 
































测试 名 称 的 重要 性 


多 留心 一 下 命名 。 长 久 看 来 ， 花 一 点 精力 起 一 个 描述 性 强 的 测试 名 称 是 值得 的 ， 这 是 因 
为 维护 代码 的 人 需要 经 常 阅读 测试 。 好 的 测试 名 称 同样 会 帮助 你 自己 ( 写 测试 的 人 ) 更 好 地 
理解 将 要 构建 的 东西 背后 的 意图 。 





(D http://code.google.com/p/googletest/wiki/V1 6 Primer#Introduction: Why Google C++ Testing Framework? 
(2) Test Case 原 意 是 指 一 个 测试 条 件 集合 ， 这 个 条 件 集合 定义 了 系统 在 此 集合 下 的 行为 。 但 在 Google 的 文档 中 ,术语 的 
意思 被 重 载 为 测试 集合 。 作 者 说 “对 于 一 些 人 来 说 ， 它 表示 一 种 测试 情境 "， 指 的 正 是 此 术语 的 原意 。 一 一 译 者 注 
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你 将 为 系统 中 的 每 个 新 行为 开发 一 些 测 试 。 将 测试 名 称 视 为 一 种 索引 ， 它 可 以 为 开发 人 
员 快 速 提供 一 个 有 关 代 码 行为 的 准确 描述 。 测 试 名 称 越 容 易 理解 ， 你 和 其 他 开发 人 员 就 能 越 
快 找 到 需要 的 东西 。 





口 第 三 行 代码 中 ， 我 们 创建 一 个 Soundex 对 象 ， 然 后 …… 停 止 ! 在 写 更 多 的 测试 之 前 ， 我 们 
知道 已 经 加 入 了 一 些 不 能 通过 编译 的 代码 : 我 们 还 没有 定义 Soundex 类 。 在 继续 编写 测试 
前 ， 先 停 下 来 去 解决 这 个 问题 。 这 个 方法 和 Bob 大 叔 关于 TDD 的 三 条 规则 保持 一 致 。 
m 只 在 为 了 使 失败 测试 通过 时 才 编 写 产品 代码 。 
m 当 测 试 刚 好 失败 时 ， 停 止 继续 编写 。 编 译 失 败 也 是 失败 。 
m 只 编写 刚好 能 让 一 个 失败 测试 通过 的 产品 代码 。 
(Bob 大 叔 就 是 Robert C. Martin。 可 以 参考 3.4 节 了 解 更 多 信息 。) 
在 使 用 C++ 时 , 增 量 地 获得 反馈 是 很 好 的 方法 ,因为 有 时 候 只 需 几 行 测试 代码 ， 就 能 产生 
一 大 堆 编译 错误 。 若 能 及 时 看 到 所 写 代码 产生 的 错误 ， 那么 将 会 更 容易 地 解决 它们 。 
撤 开 TDD 的 三 条 原则 不 谈 ， 有 时 候 你 会 觉得 ， 在 运行 测试 之 前 编写 完整 测试 更 靠 谱 ，, 或 
许 这 有 助 于 更 好 地 理解 应 该 怎样 设计 待 测试 的 接口 。 你 或 许 也 会 觉得 不 值得 花费 额外 的 
编译 时 间 ， 来 获得 更 及 时 的 反馈 信息 。 
但 是 现在 ,尤其 在 学 习 TDD 时 ， 及 时 获得 反馈 很 有 有用。 归根结底 ， 还 是 由 你 决定 怎样 增 
量 地 设计 每 个 测试 。 
编译 器 显示 我 们 需要 Soundex 类 。 可 以 为 Soundex 添 加 一 个 编译 单元 (一 对 .h/.cpp 文 件 )， 但 是 
先 别 自 找 麻 烦 。 相 反 ， 不 要 急于 使 用 独立 文件 ， 先 简单 地 在 包含 测试 的 文件 中 声明 "所 有 的 东西 。 
在 准备 提交 代码 , 或 苦于 所 有 东西 都 放 在 一 个 文件 中 的 时 候 , 再 以 适当 的 方式 把 测试 从 产品 
代码 中 剥离 。 















































































































































c2/2/SoundexTest.cpp 


> class Soundex( 
>}; 


#include "gmock/gmock.h" 


TEST(SoundexEncoding, RetainSoleletterOfOneLetterWord) { 
Soundex soundex; 


} 





CD 作者 在 书 中 许多 地 方 未 区 分 声明 (declare) 和 定义 〈define )。 不 过 这 只 是 一 个 小 细节 ， 并 不 影响 主题 的 论述 。 读 
者 在 阅读 时 可 以 依据 上 下 文 作 出 判断 。 译 者 注 
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提问 : 把 所 有 东西 放 在 一 个 文件 中 不 是 危险 的 捷径 吗 ? 

回答 : 这 是 一 种 短期 内 不 引入 复杂 开销 而 节省 时 间 的 方式 。 前 提 是 稍 晚 些 分 开 文 件 
产生 的 开销 , 小 于 一 直 在 文件 间 来 回 切 换 的 开销 。 当 以 TDD 的 方式 为 一 个 新 行为 打磨 设 
计时 ， 很 可 能 经 常 改变 接口 。 过 早 地 拆 分 出 头 文件 往往 只 会 成 为 累 玲 。 

说 到 “危险 ”"， 你 忘记 过 在 提交 代码 前 拆 分 文件 吗 ? 

提问 ; 但 是 遵循 TDD 周 期 的 话 , 你 不 是 应 该 要 清理 代码 的 吗 ? 你 不 是 一 直 要 保证 代 
码 尽量 维持 在 最 高 质量 吗 ? 

回答 : 一 般 而 言 ， 这 两 个 问题 的 答案 是 肯定 的 。 但 是 我 们 的 代码 没 问题 ,我 们 只 是 
在 确实 需要 的 时 候 ， 才 选择 一 个 更 有 效 的 组 织 方 式 。 在 真 的 需要 之 前 ， 我 们 推 延 了 做 这 
种 复杂 的 事情 ， 否 则 过 早 地 引入 这 些 复 杂 性 往往 会 使 开发 速度 变 慢 。( 一 些 敏捷 支持 者 
使 用 缩写 YANGI You ain't gonna need it; ) 

如 果 这 种 理念 深 深 地 困扰 你 , 就 马上 把 东西 分 散 到 不 同 的 文件 吧 ! 你 依然 能 够 进行 
其 余 的 练习 。 但 是 ,我 建议 先 试 一 试 这 种 方法 。TDD 以 一 种 安全 的 方式 磨 碟 你 ， 所 以 要 
敢于 尝试 你 认为 可 能 更 有 效 的 工作 方式 。 











我 们 遵循 了 第 三 条 规则 : 只 编写 刚好 让 一 个 失败 测试 通过 的 产品 代码 。 很 显然 , 我 们 还 没有 





完成 测试 。RetainsSoleLetterOfOneLetterWord 并 没有 测试 任何 行为 , 所 以 它 验证 不 了 什么 。 然 而 ， 
我 们 却 可 以 对 出 现 的 任何 负 反馈 "及 时 采取 应 对 措施 ( 这 里 的 情况 是 编译 失败 ), 加 入 足够 的 代码 























消 掉 它 。 为 使 编译 通过 ， 我 们 加 入 了 Soundex 类 的 一 个 空 定 义 。 




















这 个 时 候 构建 并 执行 测试 就 能 得 到 正 反馈 了 。 如 下 : 


[==========] Running 1 test from 1 test case. 

[---------- ] Global test environment set-up. 

[---------- ] 1 test from SoundexEncoding 

[ RUN ] SoundexEncoding.RetainsSoleLetterOfOneLetterWord 

[ OK ] SoundexEncoding.RetainsSoleLetterOfOneLetterWord (0 ms) 
[---------- ] 1 test from SoundexEncoding (0 ms total) 

[---------- ] Global test environment tear-down 

[==========] 1 test from 1 test case ran. (0 ms total) 

[ PASSED ] 1 test. 

欢乐 时 刻 ! 


等 等 ， 还 不 算 。 毕 竟 ， 

















这 个 测试 除了 构造 一 个 Soundex 类 的 实例 ( Soundex 还 是 个 空 类 )， 没 




















做 任何 事情 。 但 是 , 我 们 已 经 有 了 一 些 基 本 的 要 素 。 更 重要 的 是 , 我 们 已 经 证 明了 目前 所 做 的 是 


正确 的 。 








你 进行 到 这 一 步 了 吗 ? 你 有 没有 拼 错 include 的 文件 名 ,或 者 忘记 在 class 定 义 后 加 上 分 号 ? 
WRA, WER! 你 已 经 以 最 少 的 代码 制造 出 了 错误 。 在 TDD 中 , 如果 上 践 行 这 种 安全 编码 方式 的 








CD 负 反 馈 即 为 任何 错误 。 与 之 对 应 的 是 正 反 馈 。 一 一 译 者 注 
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话 ， 即 尽早 并 频繁 地 测试 ， 通 常 测试 失败 的 原因 只 有 一 个 。 

















测试 通过 了 , 是 时 候 将 代码 提交 到 本 地 了 。 你 











合适 的 工具 吗 ? 一 个 好 的 版 本 控制 系统 ， 让 


你 可 以 在 代码 状态 好 (或 者 说 ， 所 有 测试 都 通过 ) 的 时 候 方 便 地 提交 代码 。 如 果 稍 后 遇 到 麻烦 的 











话 ， 很 容易 将 代码 回 深 到 一 个 已 知 的 完好 状态 ， 








重新 尝试 改动 。 


TDD 的 一 部 分 理念 是 , 每 个 通过 的 测试 都 代表 了 加 入 到 系统 中 的 、 已 经 验证 了 的 行为 。 当然 ， 
这 并 不 一 定 意味 着 可 以 发 布 代码 了 。 但 是 , 更 多 地 以 此 增 量 的 方式 思考 和 频繁 地 集成 本 地 已 经 验 





证 通过 的 功能 ， 成 功 的 几率 就 会 大 大 增加 。 





继续 吧 ! 往 测试 中 加 入 一 行 代 码 , 来 表明 我 们 期 待 的 客户 端 代码 与 Soundex 对 象 的 交互 方式 。 





c2/3/SoundexTest.cpp 


TEST(SoundexEncoding, RetainSoleletterOfOneLetterWord) { 


Soundex soundex; 


» auto encoded = soundex.encode("A"); 


} 


我 们 在 添加 测试 的 同时 也 在 作 决 定 。 如 上 述 代码 所 示 ， 我 们 决定 Soundex 类 暴露 一 个 名 为 





encode() 的 公共 成 员 函 数 ， 它 有 一 个 字符 串 类 型 的 参数 。 尝 试 编 























尚 不 存在 。 这 一 负 反 馈 迫 使 我 们 去 写 足 够 的 代码 ， 让 测试 通过 编译 ， 然 后 运行 。 


c2/A/SoundexTest.cpp 


class Soundex 


1 
» public: 























std::string encode(const std::string& word) const ( 


» 
» return "" 
» } 

}; 


现在 代码 可 以 编译 了 , 所 有 的 测试 也 可 以 通 



































过 ,这 还 算 不 上 非常 有 趣 的 时 刻 。 是 时 候 验 证 





译 会 导致 失败 ， 因 为 encode () 


些 有 用 的 东西 了 : 给 定 一 个 字母 A，encode() 能 返回 正确 的 Soundex 代 码 吗 ? 我 们 用 一 个 断言 





(assertion ) 来 表达 这 一 关注 。 


c2/5/SoundexTest.cpp 


TEST(SoundexEncoding, RetainSoleletterOfOneLetterWord) { 


Soundex soundex; 
auto encoded = soundex.encode("A"); 


» ASSERT THAT(encoded, testing::Eq("A")); 
} 





断言 可 用 来 验证 结果 是 否 符 合 预期 。 上 面 代码 中 的 断言 声明 了 encode0 返 回 的 字符 串 等 于 指 
定 的 字符 串 。 现 在 ， 编 译 是 通过 了 ， 但 是 断言 却 失败 了 。 
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[==========] Running 1 test from 1 test case. 


[---------- ] Global test environment set-up. 
[---------- ] 1 test from SoundexEncoding 
[ RUN ] SoundexEncoding.RetainsSoleLetterOfOneLetterWord 


SoundexTest.cpp:21: Failure 

Value of: encoded 

Expected: is equal to 0x806defb pointing to "A" 
Actual: "" (of type std::string) 


[ FAILED ] SoundexEncoding.RetainsSoleLetterOfOneLetterWord (0 ms) 
[---------- ] 1 test from SoundexEncoding (0 ms total) 

[---------- ] Global test environment tear-down 

[==========] 1 test from 1 test case ran. (0 ms total) 

[ PASSED ] O tests. 

[ FAILED ] 1 test, listed below: 

[ FAILED ] SoundexEncoding.RetainsSoleLetterOfOneLetterWord 1 FAILED TEST 


1 FALED TEST 


乍 一 看 ，Google Mock 给 出 的 相关 输出 信息 可 能 不 太 容 易 读 懂 。 从 最 后 一 行 开始 看 吧 ! 如 果 
是 PASSED ， 可 以 不 用 看 测试 的 输出 ， 因 为 所 有 测试 都 过 了 ! 如 果 是 FAILED (正如 示例 一 样 )， 
我 们 可 以 看 到 有 多 少 测试 失败 了 。 如 果 是 其 他 类 别 的 信息 , 则 是 测试 程序 在 一 个 测试 运行 过 程 中 
BY. 

如 果 有 一 个 或 多 个 测试 失败 了 , 可 以 从 下 至 上 观察 Google Mock 输 出 信息 , 找到 失败 的 测试 。 
Google Mock 会 在 每 个 测试 名 称 前 输出 一 个 [RUN] ， 在 测试 失败 的 情况 下 输出 [FAILED] 或 [OK] 。 
失败 的 时 候 ，[RUN] 和 [FAILED] 之 间 的 信息 行 可 以 帮助 我 们 了 解 测试 为 什么 失败 。 在 上 面 这 个 示 
例 中 ， 可 以 看 到 下 面 信息 : 


[ RUN ] SoundexEncoding.RetainsSoleLetterOfOneLetterWord 
SoundexTest.cpp:21: Failure 
Value of: encoded 
Expected: is equal to 0x806defb pointing to "A" 
Actual: "" (of type std::string) 
[ FAILED ] SoundexEncoding.RetainsSoleLetterOfOneLetterWord (0 ms) 
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这 个 断言 失败 的 意思 是 ，Google Mock 期 待 一 个 名 为 encoded 的 局 部 变量 的 值 为 "A"， 但 实际 
是 一 个 空 字符 串 。 

这 个 断言 失败 是 意料 之 中 的 , 因为 为 了 通过 编译 , 我 们 特意 硬 编码 了 一 个 空 字符 串 。 得 到 这 个 
负 反 馈 其 实 是 好 事 ， 而 且 这 也 属于 TDD 周 期 内 可 以 发 生 的 事情 。 首 先 ， 我们 正 是 想 确 保 新 加 的 断 
言 不 能 通过 ， 它 代表 了 还 没 实现 的 功能 。( 有 时 候 是 通过 的 ， 通 常 这 不 是 个 好 事情 ， 参 考 3.5 节 )。 
我 们 也 想 确 保 测 试 是 有 效 的 。 起 初 测试 失败 , 在 加 入 适当 的 代码 后 通过 了 , 这 也 说 明 测试 是 可 靠 的 。 
失败 的 测试 提醒 我 们 编写 仅 够 通过 断言 的 代码 即 可 。 如 下 : 





的 值 


































































































c2/4/SoundexTest.cpp 
std::string encode(const std::string& word) const ( 
» return "A"; 


} 
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现在 编译 并 重新 运行 测试 。 最 后 两 行 的 输出 显示 测试 通过 。 


[==========] 1 test from 1 test case ran. (0 ms total) 
[ PASSED ] 1 test. 


发 布 吧 ! 

我 是 在 开玩笑 吗 ? WIE, 不 是 的 。 我 们 想 以 渐进 的 方式 工作 。 这 么 说 吧 : 如 果 某 人 告诉 我 们 
去 构建 一 个 Soundex 类 ， 而 且 只 支持 字母 A 即 可 ， 那 我 们 已 经 完成 了 。 自 此 ， 我 们 还 想 把 代码 弄 
得 更 干净 些 ， 但 仅 此 而 已 ， 不 需要 额外 的 处 理 逻 辑 。 

另外 一 个 说 法 是 , 测试 表明 了 目前 系统 拥有 的 功能 。 现在 只 有 一 个 测试 。 为 什么 还 要 添加 超 
出 此 测试 所 测 行 为 之 外 的 代码 呢 ? 

当然 ,还 没完 成 。 我 们 有 大 量 的 其 他 需求 ， 这 些 需求 将 用 TDD 方 法 增 量 地 加 入 系统 。 就 目前 
已 有 的 测试 来 说 ， 我 们 也 没完 成 。 我 们 必须 清理 掉 自 己 制 造 的 一 些小 凌乱 。 




































































2.4 ”去掉 不 干净 的 代码 


什么 ? 我 们 只 写 了 一 行 产 品 代码 和 三 行 测试 代码 就 有 问题 了 啊 ? 当然 , 即便 区 区 几 行 代码 也 
非常 容易 引入 缺陷 。TDD 方 法 提供 了 这 样 的 契机 ， 当 一 些小 问题 出 现时 , 我 们 可 以 及 时 修复 , 这 
样 就 避免 小 问题 越 积 越 多 (甚至 产生 一 些 大 问题 )。 

我 们 先 审 阅 一 下 刚 写 的 测试 和 产品 代码 ， 找 一 找 缺 陷 吧 ! 有 一 点 是 可 以 确定 的 , 测试 中 的 断 
言 不 是 非常 便于 阅读 。 

ASSERT THAT(encoded, testing::Eq("A")); 

和 测试 声明 (测试 用 例 和 测试 名 称 的 组 合 ) 类 似 ， 我们 也 希望 断言 读 起 来 像 个 句子 。 为 此 ， 
我 们 引入 using 指 示 符 来 帮忙 。 
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c2/7/SoundexTest.cpp 
#include "gmock/gmock.h" 
> using ::testing::Egq; 


TEST(SoundexEncoding, RetainSolelLetterOfOneLetterWord)(1 
Soundex soundex; 
auto encoded = soundex.encode("A"); 
» ASSERT THAT(encoded, Eq("A")); 
} 


MÆ nf RARER A T: 断言 encoded 的 值 等 于 "A"。 

我 们 称 这 一 小 改动 为 重 构 , 重 构 是 一 种 代码 改写 , 其 特点 是 在 保持 现 有 行为 不 变 的 前 提 下 改 
进 设计 。 这里, 我 们 通过 增强 测试 的 表达 力 来 提升 测试 的 设计 。Eq() 所 在 的 命名 空间 是 一 个 与 测 
试 本 意 无 关 的 实现 细节 。 隐 藏 这 一 细节 可 以 提升 测试 中 的 抽象 程度 。 
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另 一 个 难点 是 ,我 们 常常 要 面 对 重 复 代 码 。 一 旦 有 大 量 的 重复 代码 ， 维 护 成 本 和 风险 就 会 大 
大 增加 。 
我 们 的 Soundex 类 还 没有 明显 的 重复 代码 。 但 是 ， 一 并 看 一 下 测试 代码 和 产品 代码 ， 就 会 发 
现 一 个 公共 的 常量 ， 字 符 串 "A"。 我 们 想 去 除 这 一 重复 代码 。 还 有 一 个 问题 ， 测 试 名 称 
( RetainsSoleLetterOfOneLetterWord ) 声明 了 一 个 一 般 的 行为 , 但 是 代码 实现 仅仅 支持 一 个 特定 的 
单个 字母 。 我 们 想 找 一 个 一 箭 双 有 雕 的 方法 去 掉 这 个 人 硬 编码 的 "A"。 
直接 返回 传人 的 字符 串 可 以 吗 ? 















































c2/8/SoundexTest.cpp 

class Soundex 

1 

public: 

std::string encode(const std::string& word) const ( 
» return word; 
) 

}; 

任何 时 候 , 一 个 完整 的 测试 集合 声明 了 系统 中 期 望 的 行为 。 这 里 蕴含 着 一 个 潜台词 : 如 果 一 
个 行为 没有 对 应 的 测试 来 描述 ， 那 这 个 行为 要 么 不 存在 , 要 么 不 是 期 望 的 (或 者 测试 本 身 没有 尽 
到 描述 行为 的 职责 )。 

那 该 怎么 办 呢 ? 现在 有 一 个 测试 。 但 它 只 支持 单个 字母 的 单词 。 所 以 ， 可 以 假定 Soundex 类 
仅 需 要 支持 单个 字母 的 单词 ， 至 少 目前 是 这 样 。 如 果 所 有 的 单词 都 只 有 一 个 字母 ,那么 最 简单 的 
通用 方案 就 是 直接 返回 传 给 encode ( ) 的 单词 。 

[其 他 TDD 流 派 会 想 ， 如 果 不 这 样 做 ， 编 出 来 的 代码 会 是 什么 样 的 ? 一 个 可 行 的 技巧 是 
Triangulation" ( 参见 10.4.2 节 )， 写 一 个 类 似 的 断言 ， 但 是 有 不 同 的 数据 期 望 。 你 会 在 书 中 发 现 更 
多 可 行 的 方法 ， 但 是 目前 先 使 事情 保持 简单 。] 

刚才 的 改动 都 很 小 且 琐 碎 , 但 是 当下 完成 这 些 改动 是 合 时 宜 的 。TDD 中 的 重 构 步 又 给 予 我 们 
关注 所 有 问题 的 契机 , 不 论 问 题 是 大 还 是 小 ， 都 是 由 小 的 、 独 立 的 代码 改变 引起 的 。 当 历经 TDD 
的 各 个 周期 时 ， 我 们 会 使 用 重 构 来 审阅 设计 ， 同 时 修复 出 现 的 所 有 问题 。 

重 构 的 主要 关注 点 是 提升 表达 能 力 ， 去 除 重复 代码 。 就 代码 的 可 维护 性 来 说 ,这 两 个 点 最 有 
神 益 。 在 本 书 的 后 面 章节 ， 我 们 将 使 用 一 些 其 他 的 设计 知识 ， 壁 如 SOLID 设 计 原 则 和 代码 坏 味 。 














































































































(D Test Driven Development: By Example [Bec02] 
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25 Nimm 


问答 时 间 到 了 ! 


提问 : 你 真 的 对 明知 道 将 要 替换 的 东西 
回答 : 我 总 是 被 问 到 这 个 问题 。 答 案 是 
提问 : 这 似乎 不 明智 ! 
回答 : 这 不 是 个 问题 ,但 是 在 第 一 次 接触 这 种 方式 时 ,认为 它 不 明智 是 正常 的 。 我 
也 曾经 有 过 这 样 的 感受 。 我 是 过 来 人 。 
提问 : 你 会 一 直 以 此 方式 工作 吗 ? 如 果 对 所 有 东西 硬 编码 ， 那 怎么 能 够 搞定 所 有 事 
情 ? 
回答 : 这 是 两 个 问题 , 但 我 很 乐意 一 并 回答 ! 是 的 , 我 们 会 一 直 以 增 量 的 方式 工作 。 

这 个 技巧 能 快速 让 测试 通过 。 不 要 担心 , 硬 编码 的 东西 最 多 存在 一 小 会 。 我 们 心里 清楚 

离 目 标 还 有 一 段 距离 ， 所 以 需要 写 更 多 的 测试 来 描述 这 些 行为 。 在 这 个 例子 中 ,还 要 实 

现 其 他 的 规则 。 在 接 下 来 编写 其 他 测试 时 ， 我 们 将 会 用 有 趣 的 逻辑 替换 掉 硬 编码 ， 使 测 

试 通过 。 

增 量 性 是 TDD 取 得 成 功 的 关键 。 乍 一 看 , 增 量 方法 显得 非常 不 自然 且 速 度 慢 。 但 是 ， 随 着 时 
间 的 推移 , 小 步 的 增 量 开发 反而 能 够 加 快 你 的 速度 , 部 分 原因 是 这 可 以 避 开 由 一 次 编写 而 成 的 大 
量 且 复杂 的 代码 产生 的 错误 。 坚 持 它 ! O 

精明 的 读者 或 许 注意 到 了 ， 我 们 编写 的 代码 并 不 完全 符合 Soundex 的 规范 。 规 则 4 的 最 后 说 ， 
如 果 没 有 三 个 数字 ， 需 要 补 零 。 喔 ， 这 就 是 规范 的 乐趣 所 在 ! 我 们 必须 认真 且 全 面 地 阅读 它 ,， 彻 
底 理解 各 个 部 分 是 怎样 交互 的 。( 最 好 与 用 户 沟 通 ， 他 会 前 明 哪些 是 期 望 的 。) 目前 来 说 ， 规 则 4 
和 我 们 所 实现 的 代码 尚 不 吻合 。 


想象 一 下 , 这些 规 则 是 逐个 向 我 们 提出 的 。“ 先 把 规则 1 的 第 一 部 分 完成 ,然后 再 给 你 下 一 条 
规则 。” TDD 与 后 一 种 方法 一 致 ， 规 范 的 各 个 部 分 是 增 量 地 编写 进 系统 。 这 一 方法 可 以 使 我 们 以 


进行 硬 编码 吗 ? 
肯定 的 。 













































































































































































而 言 ， 我 们 可 能 要 花费 更 多 的 时 间 合 并 新 的 代码 。 稍 后 再 来 讨论 这 个 问题 。 目 前 来 说 ， 先 看 看 没 
有 这 个 权衡 ， 会 发 生 什 么 。 
现在 有 两 个 工作 要 做 : 为 新 行为 写 一 个 新 测试 ; 修改 已 有 的 测试 以 满足 规范 。 下 面 是 新 测试 : 

















c2/9/SoundexTest.cpp 


TEST(SoundexEncoding, PadsWithZerosToEnsureThreeDigits) { 
Soundex soundex; 








@ 小 步 开发 出 来 的 代码 更 容易 适应 未 来 的 需求 和 变化 。 一 一 译 者 注 
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auto encoded = soundex.encode("I"); 


ASSERT THAT(encoded, Eq("I000")); 
} 


(一 个 审阅 人 提出 问题 :“ 为 什么 在 编写 测试 前 不 认真 地 阅读 Soundex 规 则 呢 ? ”好 问题 ! 的 
确 , 我 们 没有 认真 阅读 规范 。TDD 的 一 个 强项 就 是 在 信息 不 完全 的 情况 下 , 我 们 依然 可 以 向 前 推 
进 ， 并 且 可 以 在 得 到 新 信息 后 及 早 纠 正之 前 的 代码 。) 

加 入 的 每 个 测试 都 是 独立 的 。 我 们 不 会 将 一 个 测试 的 结果 作为 另 一 个 测试 的 前 提 。 每 个 测试 
必须 设置 好 自己 的 上 下 文 。 所 以 ， 新 加 的 测试 需要 创建 自己 的 Soundex 类 实例 。 

运行 测试 后 ， 测 试 结果 提示 ，encode() 返 回 的 是 " 工 "而 非 "I009" 。 让 它 通 过 很 简单 。 






























































c2/9/SoundexTest.cpp 


std::string encode(const std::string& word) const ( 
» return word + "000"; 


) 

硬 编码 可 能 再 次 导致 事情 乱 作 一 团 ， 但 它 能 帮助 我 们 不 跑 偏 。 就 我 们 目前 的 测试 而 言 ， 
Soundex 类 不 需要 额外 的 行为 。 此 外 , 通过 采取 尽 可 能 小 的 步伐 , 我 们 在 往 系 统 中 加 入 新 行为 时 ， 
必须 编写 额外 的 测试 。 

新 的 测试 通过 了 , 但 是 第 一 个 测试 失败 了 。 这 是 因为 测试 描述 的 行为 和 维基 百科 上 列 出 的 规 
范 不 吻合 。 

如 果 一 个 测试 通过 了 , 就 说 明 这 个 测试 正确 地 描述 了 系统 是 如 何 工作 的 。 如 果 测 试 设计 得 好 ， 
那么 会 起 到 例子 的 作用 ， 比 规范 更 易 读 。 在 接 下 来 的 练习 中 , 我 们 会 继续 专注 让 测试 具有 可 读 性 
(我 偶尔 甚至 把 它们 称 之 为 规范 )。 



































c2/9/SoundexTest.cpp 


TEST(SoundexEncoding,RetainsSoleLetterOfOneLetterWord)( 
Soundex soundex; 


auto encoded = soundex.encode("A"); 


» ASSERT THAT(encoded, Eq("A000")); 
j 


如 上 述 代 码 所 示 ， 让 第 一 个 测试 通过 并 不 难 ! 

现在 有 两 个 大 体 相同 的 测试 ， 只 是 数据 稍微 有 点 差别 。 这 没关系 。 每 个 测试 分 别 描述 一 种 行 
为 。 我 们 不 仪 要 确保 系统 按 预 期 工作 ， 还 要 让 每 个 人 知道 所 有 既定 的 系统 行为 。 

是 时 候 重 构 了 。encode() 中 的 代码 在 描述 其 中 可 能 发 生 的 操作 时 有 点 模糊 其 词 。 我 们 决定 
提取 独立 的 方法 (Method )， 配 以 意图 明确 的 名 字 。 
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c2/10/SoundexTest.cpp 


public: 
std::string encode(const std::string& word) const ( 
» return zeroPad(word); 
} 
private: 
» std::string zeroPad(const std::string& word) const ( 
» return word + "000"; 
» J 


2.6 fixture 与 设置 


在 重 构 的 时 候 


， 不 仅 要 审阅 产品 代码 ， 还 要 审阅 测试 。 如 上 所 述 ， 我 们 的 测试 都 需要 创建 





Soundex 类 实例 ， 并 且 使 用 相同 的 代码 。 我 们 不 乐意 看 到 此 类 貌似 无 关 紧 要 的 重复 代码 。 这 些 重 


复 会 积累 得 很 快 ， 并 | 
阅读 代码 的 人 来 说 ， 


相关 测试 拥有 一 





日 通常 会 演变 为 更 复杂 的 重复 代码 。 这 也 会 让 测试 变 得 有 点 主 次 不 分 ， 对 于 
这 会 分 散 注 意 力 ， 从 而 忽视 真正 需要 关注 的 重要 内 容 。 


些 共 同 的 代码 是 常见 的 。Google Mock 人 允许 我 们 定义 一 个 fixture 类 ， 我 们 可 





以 在 这 个 类 中 为 相关 的 测试 声明 函数 和 数据 。( 从 技术 角度 说 , 所 有 的 Google Mock 测 试 都 使 用 一 
个 由 Google Mock 自 己 生成 的 fixture。 ) 


c2/10/SoundexTest.cpp 


public: 


YYVYY 


}; 


M 


class SoundexEncoding : public testing::Test { 


Soundex soundex; 


TEST F(SoundexEncoding, RetainsSoleletterOfOneLetterWord) { 


auto encoded = soundex.encode("A"); 


ASSERT THAT(encoded, Eq("A000")); 


} 


Y 


TEST F(SoundexEncoding, PadsWithZerosToEnsureThreeDigits) { 


auto encoded = soundex.encode("I"); 


ASSERT THAT(encoded, Eq("I000")); 


} 
我 们 在 上 述 代码 





中 创建 了 一 个 名 为 SoundexEncoding 的 fixture ( 必须 从 ::testing::Test 继 承 )。 这 


FÉ, 创建 Soundex 类 实例 就 在 一 个 地 方 完成 了 。 在 fixture 内 部 , 我 们 声明 了 公共 成 员 变量 soundex， 
以 便 测 试 可 以 访问 。( 如 果 你 对 暴露 变量 soundex 有 点 担心 的 话 ， 记 住 fixture 类 只 在 这 个 .cpp 文 件 
中 。 我 们 想 避 免 在 测试 中 加 入 多 余 的 杂乱 代码 。) 


Google Mock 会 在 运行 每 个 测试 时 创建 fxture 类 实例 。 在 Google Mock 运 行 RetainSole- 
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LetterOfOneLetterWord 前 ， 它 先 创 建 一 个 SoundexEncoding 类 实例 。 在 运行 PadsWithZeroTo- 
EnsureThreeDigits 前 ， 创 建 男 外 一 个 SoundexEncoding 类 实例 。 为 了 使 用 自 定义 的 fixture， 我 们 把 
TEST 宏 蔡 换 为 TEST_ F，F 表 示 fixture。 如 果 忘 记 使 用 TEST FE， 任何 使 用 了 fixture 类 成 员 的 测试 代 
码 都 会 编译 失败 。 


现在 ， 可 以 删 掉 测 试 内 的 局 部 变量 soundex， 因 为 每 个 测试 都 可 以 访问 fixture 中 的 成 员 。 我 
们 增 量 地 作出 这 些 代码 改动 。 在 定义 完 fixture 类 并 修改 宏 处 理 后 ， 我 们 从 第 一 个 测试 中 删 掉 局 部 
变量 soundex。 运 行 所 有 的 测试 来 验证 这 个 改动 ， 继 而 删 掉 第 二 个 测试 中 的 局 部 变量 soundex， 
然后 再 次 运行 所 有 的 测试 。 
去 掉 测试 中 重复 的 Soundex 类 实例 定义 至 少 会 产生 下 面 两 个 影响 。 


a 提升 了 测试 的 抽象 度 。 现 在 ,每 个 测试 中 只 包含 两 行 代码 ， 这 有 助 于 我 们 集中 精力 关注 
与 测试 相关 的 东西 。 我 们 也 看 不 到 Soundex 类 实例 是 怎样 构造 出 这 一 不 相干 的 细节 的 〈 参 
见 7.4 节 ， 详 细 了 解 为 什么 这 很 重要 )。 

口 可 以 降低 未 来 维护 测试 的 开销 。 试 想 一 下 我 们 必须 改变 Soundex 类 实例 的 构造 方式 ( 壁 如 

我 们 需要 能 够 将 语言 种 类 作为 一 个 构造 函数 的 参数 ) 将 Soundex 类 实例 的 构造 放 到 fixture 

中 ， 这 意味 着 改动 一 个 地 方 即 可 。 否 则 ， 要 改动 每 个 测试 。 


每 个 测试 只 有 两 行 代码 , 这 让 测试 更 具 可 读 性 。 还 可 以 做 些 什么 呢 ? 我 们 可 以 让 每 个 测试 只 有 
一 行 代码 ， 同 时 保持 可 读 性 。 另 外 ， 我 也 不 是 显 式 使 用 using 指 示 符 的 拥 是 ， 所 以 也 可 以 去 掉 它 。 







































































c2/11/SoundexTest.cpp 


#include "gmock/gmock.h" 
> #include "Soundex.h" 


> using namespace testing; 


> class SoundexEncoding: public Test { 
public: 
Soundex soundex; 


h 


TEST F(SoundexEncoding, RetainsSoleLetterOfOneLetterWord) ( 
» ASSERT THAT(soundex.encode("A"), Eq("A000")); 
} 


TEST F(SoundexEncoding, PadsWithZerosToEnsureThreeDigits) { 
» ASSERT THAT(soundex.encode("I"), Eq("I000")); 
































) 
从 上 述 代码 中 可 以 看 到 ， 测 试 仅仅 引用 了 Soundex.h 头 文件 。 短 期 内 ， 测 试 和 产品 代码 同 在 
一 个 文件 是 有 益 的 。 但 现在 , 我 们 需要 在 一 个 文件 中 不 断 地 拉 上 拉 下 ,所 以 有 点 费力 。 先 把 测试 








和 头 文件 分 开 ( 稍 后 再 决定 是 否 应 该 创建 .impl 文 件 )， 下 面 是 头 文件 。 
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c2/11/Soundex.h 
> #ifndef Soundex h 
» #define Soundex h 
#include «string» 


class Soundex 
1 
public: 
std::string encode(const std::string& word) const ( 
return zeroPad(word); 


) 





private: 
std::string zeroPad(const std::string& word) const { 
return word + "000"; 
} 
}; 


> #endif 


2.7 思索 与 测试 驱动 开发 


简单 地 说 ,， TDD 的 周期 就 是 写 一 个 测试 ， 先 确保 测试 失败 ， 然后 编码 让 测试 通过 ,接着 审阅 
代码 和 打磨 设计 (包括 测试 的 设计 )， 最 后 确保 所 有 测试 依然 通过 。 在 一 天 的 工作 中 ， 你 不 断 地 
重复 此 周期 , 保持 周期 短小 ， 以 便 得 到 最 多 的 反馈 。 虽然 是 重复 , 但 绝 非 盲 目 ， 每 一 个 周期 你 都 
需要 思考 很 多 事情 。3.3 节 列 出 了 每 一 步 需要 回答 的 问题 。 

为 了 保持 事情 持续 推进 ， 假 定 你 遵从 了 上 面 提 到 的 步骤 , 我 只 会 偶尔 提醒 一 下 。 你 可 以 在 显 
示 器 边 上 贴 一 个 便签 用 作 提醒 。 


在 下 一 个 测试 中 ,我们 将 处 理 规则 2 ( 即 在 第 一 个 字母 后 ,用 数字 替换 辅音 )。 替 换 规则 表 中 
说 字母 6 对 应 数字 1。 那 就 先 写 个 这 样 的 测试 ， 如 下 : 






























































c2/12/SoundexTest.cpp 


TEST F(SoundexEncoding, RetainsSolelLetterOfOneLetterWord) { 
» ASSERT THAT(soundex.encode("Ab"), Eq("A100")); 
} 


不 出 意料 ， 测 试 失败 了 。 


Value of: soundex.encode("Ab") 
Expected: is equal to 0x80b8a5f pointing to "A100" 
Actual: "Ab000" (of type std::string) 


如 大 部 分 要 写 的 测试 一 样 ,对 应 的 解决 方案 可 能 枚 不 胜 举 , 但 可 能 只 有 少量 是 合理 的 。 从 技 
术 角 度 讲 ， 唯 一 要 做 的 是 让 这 个 测试 通过 ， 然 后 打磨 我 们 的 解决 方案 


但 是 ,我 们 寻求 的 是 通用 的 解决 方案 ( 也 不 要 过 于 通用 ， 以 至 于 考虑 过 多 )， 也 不 要 对 已 处 
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理 过 的 行为 重复 编码 。 
可 以 提供 一 个 让 测试 通过 的 解决 方案 ， 如 下 : 


std::string encode(const std::string& word) const { 
if (word == "Ab") return "A100"; 
return zeroPad(word); 


} 

然而 ,对 于 用 数字 替换 辅音 而 言 ， 这 一 段 代码 不 是 通用 的 解决 方案 。 它 也 引入 了 一 些 重复 的 
东西 : 特例 "Ab" 的 结果 为 "A1" 的 补 零 对 齐 输出 ， 即 "A109" ， 但 是 我 们 已 经 有 了 对 任何 词 做 补 零 
操作 的 通用 代码 。 

你 可 能 认为 这 个 理由 不 太 充分 , 或 许 是 吧 。 如 果 不 限 定时 间 ,， 你 能 给 出 的 替代 方案 数目 可 能 
也 是 无 穷 无 尽 的 。 但 是 TDD 不 是 纯粹 的 科学 , 相反 ,可 以 把 它 想 成 软件 工匠 用 来 增 量 开发 代码 的 
工具 。 这 个 工具 适合 持续 的 实验 、 发 现 和 改进 。 


行动 胜 于 空谈 ! 下 面 是 迈 向 通用 解决 方案 的 一 步 : 






























































c2/13/Soundex.h 


std::string encode(const std::string& word) const ( 
auto encoded = word.substr(0, 1); 


if (word.length() » 1) 
encoded += "1"; 
return zeroPad(encoded); 


} 
运行 一 下 ， 新 的 测试 没有 通过 。 


Expected: is equal to 0x80b8ac4 pointing to "A100" 
Actual: "A1000" (of type std::string) 


补 齐 逻辑 不 对 。 必 须 修改 它 ， 以 考虑 到 待 编码 词 的 长 度 。 


YYVYVVYYN 




















c2/14/Soundex.h 


std::string zeroPad(const std::string& word) const ( 
» auto zerosNeeded = 4 - word.length(); 
» return word + std::string(zerosNeeded, '0'); 


) 

测试 通过 了 。 KET! 但 是 代码 看 起 来 变 得 有 点 乏味 。 当 然 , 我 们 知道 自己 编写 的 encode() 
是 怎样 工作 的 。 但 是 其 他 人 可 能 需要 花 更 多 时 间 ， 仔细 阅读 代码 ， 以 理解 其 背后 的 意图 。 其 实 我 
们 可 以 做 得 更 好 。 先 把 它 重 构 为 更 具 可 读 性 的 方案 吧 ， 如 下 : 







































































c2/15/Soundex.h 


class Soundex 


1 
public: 
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std::string encode(const std::string& word) const ( 


» return zeroPad(head(word) + encodedDigits(word)); 
j 
private: 
» std::string head(const std::string& word) const ( 
» return word.substr(0, 1); 
» } 
» std::string encodedDigits(const std::string& word) const ( 
» if (word.length() » 1) return "1"; 
» return "" 
» } 


std::string zeroPad (const std::string& word) const { 
Hc 
} 
}; 
瞧 ， 我 们 正 一 点 点 地 完善 Soundex 编 码 算法 。 同 时 ， 重 构 有 助 于 确保 核心 算法 清晰 ， 实 现 细 
节 也 很 整洁 。 
以 声明 性 的 方式 组 织 代码 , 使 其 非常 易于 理解 。 设计 中 非常 重要 的 一 方面 是 从 实现 ( 怎么 做 ) 
中 分 离 接 口 〈 做 什么 )， 这 提供 了 迈 向 更 高 层次 设计 方案 的 跳板 。 每 到 TDD 的 重 构 环节 时 ， 都 要 
考虑 类 似 的 重组 。 
有 些 读者 或 许 担心 实现 细节 。 第 一 ， 是 不 是 应 该 用 stringstream， 而 不 是 直接 将 字符 串 连 接 起 
来 ? 第 二 ， 为 什么 不 尽 可 能 地 用 单独 的 char? 例如 ， 为 什么 用 return words.substr(0, 1); 
而 非 return word.front();? 第 三 ,用 return std::string() ;不 是 比 return "" ;更 好 吗 ? 


这 些 替 代 的 代码 方案 可 能 更 好 。 但 这 些 都 是 过 早 优化 〈premature optimization )。 这 个 时 候 ， 
一 个 好 的 设计 ( 接口 一 致 且 代 码 可 读 性 高 ) 更 重要 。 一 旦 以 牢靠 的 设计 实现 了 正确 的 行为 后 ,再 
考虑 是 否 优化 性 能 ( 吞没 有 事先 做 测量 ， 先 不 要 考虑 优化 ， 参 考 10.2 市 )。 
撤 开 过 早 的 性 能 优化 不 谈 ， 我 们 的 代码 也 确实 需要 雕琢 一 番 。 先 去 掉 使 用 神奇 的 常量 表示 
Soundex 编 码 最 大 长 度 而 产生 的 代码 坏 味 ， 取 而 代 之 , 使 用 一 个 具有 合理 名 字 的 常量 。 























































































































c2/16/Soundex.h 
static const size t MaxCodeLength{4}; 
HL Tai 
std::string zeroPad(const std::string& word) const { 
» auto zerosNeeded = MaxCodelength - word.length(); 
return word + std::string(zerosNeeded, '0'); 


你 怎么 看 待 encodeDigits ( ) 中 硬 编 码 的 字符 串 "1" 呢 ? 我 们 的 代码 需要 将 字母 b 蔡 换 为 1， 
所 以 不 能 用 变量 去 掉 这 个 硬 编 码 。 我 们 可 以 引入 另 一 个 常量 ， 或 从 一 个 名 副 其 实 的 函数 中 返回 


一 个 常量 。 
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甚至 可 以 先 不 管 这 个 硬 编码 , 待 到 下 一 个 测试 时 再 消除 它 。 但 是 我 们 能 保证 在 集成 代码 前 写 
下 一 个 测试 吗 ? 万 一 我 们 转 去 做 其 他 事情 了 呢 ? 那个 时 候 再 回头 看 这 段 代 码 , 或 许 要 花费 更 多 的 
时 间 来 理解 它 了 。 请 保持 增 量 交 付 的 态度 ， 现 在 就 来 解决 问题 ! 














c2/17/Soundex.h 


std::string encodedDigits(const std::string& word) const ( 
» if (word.length() » 1) return encodedDigit(); 
return "" 


} 


> std::string encodedDigit() const { 
» return "1"; 
> } 


2.8 ”测试 驱动 与 测试 


我 们 要 以 测试 驱动 方法 开发 更 多 的 辅音 变换 逻辑 ( 如 c 对 应 2、d 对 应 3， 等 等 )， 使 解决 方案 
更 具 通 用 性 。 为 此 ， 应 该 在 ReplacesConsonantsWithAppropriateDigits 中 加 一 个 断言 ， 还 是 再 创建 
一 个 测试 呢 ? 

TDD 的 经 验 法 则 是 一 个 测试 一 个 断言 (参考 7.3 节 , 获取 更 多 信息 ), 我 们 提倡 专注 测试 行为 ， 
而 非 测 试 功能 函数 。 大 部 分 时 候 要 遵从 这 一 个 规则 。 

对 第 二 个 辅音 进行 编码 的 断言 不 像 是 另 一 个 行为 。 如 果 创 建 一 个 这 样 的 测试 ， 该 怎么 命名 
呢 ? 难道 是 ReplacesBWith1 、ReplacesCVWith2.………: ? 

向 测试 中 加 入 第 二 个 断言 来 表示 一 个 测试 用 例 的 情况 比较 少 。 我 们 希望 一 个 断言 失败 时 , 其 
他 的 代码 能 继续 执行 。 为 此 ， 我 们 使 用 Google Mock 提 供 的 EXPECT_THAT 宏 而 非 ASSERT_THAT。 




































































c2/18/SoundexTest.cpp 


TEST F(SoundexEncoding, ReplacesConsonantsWithAppropriateDigits) { 
» EXPECT THAT(soundex.encode("Ab"), Eq("A100")); 
> EXPECT THAT(soundex.encode("Ac"), Eq("A200")); 

} 


ERRER, AAE 05 26 — if RARER O 








c2/18/Soundex.h 


std::string encodedDigits(const std::string& word) const ( 
» if (word.length() » 1) return encodedDigit(word[1]); 


return "" 
} 
> std::string encodedDigit(char letter) const { 
> if (letter == ‘c’) return "2"; 
return "1"; 
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再 加 上 第 三 种 数据 输入 情形 。 


c2/19/SoundexTest.cpp 


TEST F(SoundexEncoding, ReplacesConsonantsWithAppropriateDigits) { 
EXPECT THAT(soundex.encode("Ab"), Eq("A100")); 
EXPECT THAT(soundex.encode("Ac"), Eq("A200")) ; 
» EXPECT THAT(soundex.encode("Ad"), Eq("A300")) ; 
} 


第 三 个 辅音 处 理 情 形 让 事情 变 得 明朗 , 需要 用 一 个 基于 哈 希 (hash ) 的 集合 代替 简单 的 if 分 支 。 














c2/19/Soundex.h 


std::string encodedDigit(char letter) const ( 
const std::unordered map«char,std::string» encodings ( 
{'b', "1"}, 
[eu any, 
{'d', "3"} 
}; 
return encodings.find(letter)->second; 


} 


现在 ， 需 要 写 代码 支持 其 余 的 辅音 转换 。 问 题 是 ， 每 个 辅音 转换 功能 都 需要 以 测试 驱动 方式 
开发 吗 ? 


在 TDD 诞 生 初 期 有 个 口头 禅 :“ 可 能 出 问题 的 地 方 都 需要 测试 。” 人们 常常 会 问 :“ 我 需要 测 
试 什么 ? ”这 个 口头 禅 算是 一 个 漫不经心 的 回复 。 事 实 上 ,encoding 中 的 映射 (map ) 操作 出 现 
问题 的 风险 比较 小 。 不 挨个 测试 一 遍 ， 应 该 也 不 会 出 什么 问题 。 


一 个 相反 的 观点 是 ， 什 么 都 可 能 出 问题 ， 无 论 它 多 么 简单 〈 我 以 前 就 是 这 样 的 ， 嘿 嘿 ) 对 
重复 数据 越 是 感到 乏味 ,犯错 误 的 几率 越 大 ,甚至 不 会 注意 到 已 经 犯错 了 。 测 试 可 以 降低 犯错 的 
几率 。 


另外 , 测试 好 比 一 个 辅音 转换 为 数字 的 清晰 文档 (虽然 你 有 可 能 辩 称 表格 本 身 就 是 一 个 再 清 
楚 不 过 的 文档 了 )。 反 过 来 ,如 果 创 建 一 个 有 几 百 个 元 素 的 表格 ,为 每 个 都 提供 测试 似乎 很 荒唐 。 


正确 答案 是 什么 ? 考量 的 重点 在 于 我 们 在 做 测试 驱动 开发 ， 而 非 测 试 。 你 或 许 会 问 : 这 有 什 
么 不 同 吗 ? 答案 是 肯定 的 。 用 测试 的 技巧 ， 你 会 全 面 地 分 析 规 范 〈 也 有 可 能 是 代码 )， 并 创建 大 
量 的 测试 来 罗列 各 种 行为 。TDD 则 着 力 于 代码 设计 。 测 试 主要 用 于 表述 你 要 构建 的 行为 。TDD 
过 程 中 编写 的 测试 大 都 是 这 个 流程 的 附属 产物 。 有 了 这 些 测试 , 在 接 下 来 改动 代码 时 ， 你 会 更 有 
信心 o 

H3, TDD 与 测试 之 间 的 区 别 很 微妙 。TDD 的 一 个 重要 方面 就 是 秉承 够 用 心态 。 你 写 的 测试 
只 是 为 开发 代码 做 准备 。 当 要 开发 下 一 个 行为 时 ， 再 写 测试 。 如 果 代 码 逻 辑 不 再 变 ， 就 可 以 不 用 
写 测试 了 。 

当然 ,实际 经 验 起 决定 作用 。 直 到 发 布 一 个 缺陷 时 ，TDD 都 能 很 好 地 工作 。 但是, 一旦 选择 


YYvvvyvyv 
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TDD， 还 是 要 提醒 自己 采取 更 小 、 更 安全 的 步伐 。 


既然 选择 了 TDD ， 那 就 来 完成 转换 表 吧 ! 





c2/20/Soundex.h 


std::string encodedDigit(char letter) const ( 
const std::unordered map«char, std::string» encodings { 


> puru tI CEG "Rh DL "Ih pu Spa 
> Ce tA ig S2 a 2 UG tay quota 
» (5s, "2", [xe 429. dz n2*E 
> pau ap A e 
> (Ut "4", 
» (m "b ky HAN. 55", 
» {'r "6"} 
}; 
return encodings.find(letter)->second; 


} 








那 测试 呢 ? ReplacesConsonantsWithAppropriateDigits 中 需要 3 个 断言 吗 ? 为 了 回答 这 个 问题 ， 


先 上 自问 额外 的 测试 是 否 能 增加 对 此 功能 特性 的 至 














E 解 。 答 案 应 该 是 不 能 。 所 以 ， 去掉 两 个 断言 ,将 


剩 下 的 断言 改 用 ASSERT_THAT， 并 选择 一 个 不 同 的 辅音 来 编码 ， 以 此 增加 我 们 的 信心 。 


c2/20/SoundexTest.cpp 


TEST F(SoundexEncoding, ReplacesConsonantsWi 





thAppropriateDigits) { 


» ASSERT THAT(soundex.encode("Ax"), Eq("A200")); 


) 


2.9 如 果 出 现 别 的 情况 呢 


目前 的 实现 假定 能 够 在 encodings 映 射 中 找到 传人 encodedDigit() 的 字母 。 之 前 是 为 了 能 
慢 慢 向 前 推进 开发 ， 故 作 此 假设 ， 因 为 这 样 就 可 以 写 最 少 的 代码 来 通过 每 个 测试 。 但 是 ,依然 要 











思考 可 能 需要 写 的 其 他 代码 。 

















有 没有 可 能 传人 encodedDigit() 的 字母 没有 出 现在 查找 映射 中 ? 如 果 可 能 ， 该 怎么 应 对 ? 

















维基 百科 并 不 能 回答 这 个 问题 。 我 们 可 以 猿 , 但 是 最 好 的 答案 来 自 客户 。 如 果 没 有 客户 ,可 以 在 
网 上 搜索 一 下 ， 搜 索 会 马上 给 出 一 堆 Soundex 应 用 。 输 入 A# 会 得 到 A000。 答 案 有 了 : 需要 忽略 不 


能 识别 的 字母 。 





在 TDD 中 , 我 们 可 以 记 下 这 个 既定 测试 的 名 称 ， 或 者 现在 就 动手 写 这 个 测试 。 有 几 次 我 发 现 
提前 写 一 些 例外 情形 的 测试 ， 会 节省 后 来 调试 的 时 间 。 所 以 ， 现 在 就 来 写 这 个 测试 吧 ! 


c2/21/SoundexTest.cpp 

TEST F(SoundexEncoding, IgnoresNonAlphabetic 
ASSERT THAT(soundex.encode("A£"), Eq("A00 

} 


s) { 
0")); 
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运行 这 个 测试 , 你 会 发 现 测试 不 是 失败 了 , 而 是 崩溃 了 。 find() 返 回 了 指向 end O ARAR, 
而 我 们 却 尝试 解 引用 。 当 遇 到 这 种 情形 ， 先 修改 一 下 encodedDigit()， 返回 一 个 空 字符 串 。 








c2/21/Soundex.h 


std::string encodedDigit(char letter) const ( 
const std::unordered map«char, std::string» encodings { 
Cbr, 0I"), CF, UIS, Cp, 0D"), Cv, 17), 


Ve 
h 
» auto it = encodings.find(letter); 
» return it == encodings.end() ? "" : it-»second; 


2.10 一 次 只 做 一 件 事 
我 们 需要 测试 驱动 开发 出 代码 用 以 转换 一 个 词 末 尾 剩 下 的 字母 。 








c2/22/SoundexTest.cpp 
TEST F(SoundexEncoding, ReplacesMultipleConsonantsWithDigits) { 
ASSERT THAT(soundex.encode("Acdl"), Eq("A234")); 

} 

一 个 简单 的 方法 是 : 除了 第 一 个 字母 ， 遍 历 剩 下 的 字母 并 转换 。 但 是 ， 目 前 的 代码 结构 还 不 
太 容易 支持 这 么 做 。 先 重 构 下 代码 吧 ! 

但 是 记 住 ， 一 次 只 做 一 件 事 。 在 测试 驱动 开发 时 ， 要 保持 每 一 步 都 不 同 。 在 写 测 试 时 ， 不 要 
跑 去 重 构 。 同 样 ， 在 尝试 让 测试 通过 时 也 不 要 重 构 。 将 两 件 事 并 在 一 起 做 时 , 一旦 出 盆子 会 浪费 
时 间 。 而 且 这 肯定 会 发 生 的 。 

先 把 刚才 写 的 测试 注释 掉 ， 暂 时 停止 这 个 测试 。( 在 Google Mock'P ， 在 测试 名 称 前 加 
DISABLE 前 级 会 跳 过 执行 测试 ， 参 见 3.7 节 ， 了 解 这 样 做 的 意图 。) 



































c2/23/SoundexTest.cpp 
» TEST F(SoundexEncoding, DISABLED ReplacesMultipleConsonantsWithDigits) ( 
ASSERT THAT(soundex.encode("Acdl"), Eq("A234")); 
I 
我 们 先 专 注 于 重 构 , 修改 一 下 目前 的 解决 方案 。 不 要 将 整个 词 传人 encodedDigits() ， 而 是 
将 词尾 (除了 第 一 个 字母 外 的 其 余 字 母 ) 传人 encodedDigits()。 这 样 做 会 让 循环 处 理 待 转换 字 
母 的 代码 更 简洁 。 同 时 ， 使 用 empty() 和 front () 函数 有 助 于 澄清 代码 的 意图 。 


























c2/23/Soundex.h 
std::string encode(const std::string& word) const ( 
» return zeroPad(head(word) + encodedDigits(tail(word))); 


) 
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std::string tail(const std::string& word) const ( 
return word.substr(1); 


YYY 


H 


std::string encodedDigits(const std::string& word) const ( 
if (word.empty()) return ""; 
return encodedDigit(word.front()); 


) 
完成 后 ， 运 行 一 下 所 有 的 测试 ， 以 确保 改动 不 会 破坏 其 他 测试 。 至 此 , 重 构 工作 可 以 告 一 段 
落 了 。 


回 到 TDD 周 期 的 开始 ， 重 新 启用 ReplacesMultipleConsonantsWithDigits ， 使 其 失败 。 可 以 使 
用 一 个 基于 范围 (range) 的 for 循 环 来 遍历 词尾 ， 让 测试 通过 。 


yvy 





























c2/24/Soundex.h 


std::string encodedDigits(const std::string& word) const ( 
if (word.empty()) return ""; 


» std::string encoding; 
» for (auto letter: word) encoding += encodedDigit(letter); 
» return encoding; 


) 


既然 在 encodedDigits() 中 加 入 了 循环 , 就 不 用 应 对 传人 空 字符 串 之 类 的 防御 语句 了 。 在 重 
构 环节 中 ， 移 除 它 。 








c2/25/Soundex.h 

std::string encodedDigits(const std::string& word) const ( 
std::string encoding; 
for (auto letter: word) encoding += encodedDigit(letter); 
return encoding; 


} 


重新 运行 测试 , 测试 通过 ! 删 掉 不 必要 的 代码 是 非常 令 人 满意 的 , 但 前 提 是 要 有 足够 的 信心 。 
有 了 测试 的 保障 ， 做 这 些 代码 清理 时 你 会 感觉 真 的 很 棒 ! 














2.11 ”限制 长 度 


规则 4 声明 Soundex 编 码 结果 必须 是 4 个 字符 。 下 面 为 此 写 个 新 的 测试 。 




















c2/26/SoundexTest.cpp 


TEST F(SoundexEncoding, LimitsLengthToFourCharacters) { 
ASSERT THAT(soundex.encode("Dcdlb").length(), Eq(4u)); 
j 
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这 个 


E iu 
rd 


当 用 Google Mock 运 行 这 个 新 测试 时 ， 会 抛 出 异常 。 不 要 担心 ， 因 为 我 们 的 测试 工具 捕获 了 
异常 ， 生 成 了 测试 失败 的 报告 ， 然 后 继续 运行 其 他 的 测试 。 


RUN ] SoundexEncoding.LimitsLengthToFourCharacters 

unknown file: Failure 

C++ exception with description "basic string:: S create" thrown in the test body. 
FAILED ] SoundexEncoding.LimitsLengthToFourCharacters (1 ms) 


默认 情况 下 ，Google Mock 会 记 下 问题 ， 继 续 运 行 剩余 的 测试 。 如 果 你 喜欢 一 遇 到 未 处 理 的 
就 让 测试 骨 溃 ， 可 以 用 下 面 的 命令 行 选项 运行 Google Mock: 
--gtest catch exceptions-0 


gdb (或 类 似 的 调试 工具 ) 中 的 栈 回 溯 显 示 问 题 出 在 zeroPad () 中。 搜索 引擎 给 出 的 结果 显 
































示 ， 创 建 一 个 超出 最 大 长 度 的 字符 串 ， 导 致 了 _5_create 错 误 。 基 于 这 两 点 事实 ,我 们 集中 看 一 
下 zeroPad() 中 的 字符 串 构 造 过 程 。 当 编码 的 长 度 超出 MaxCodeLength 时 ，zeroNeeded 游 出 了 
一 个 值 ， 这 使 字符 串 构 造 函 数 失 败 。 

















TDD 方 法 学 提倡 的 增 量 方法 , 使 解决 问题 变 得 更 加 容易 , 因为 一 旦 问题 出 现 , 就 会 暴露 出 来 。 


不 需要 调试 来 精确 定位 问题 ， 看 一 眼 栈 回溯 就 足够 了 。 


《但 是 ， 只 要 程序 出 现 骨 溃 ， 就 得 思考 一 下 我 们 的 方法 。 怎 么 更 好 地 进行 测试 驱动 开发 ， 让 








问题 的 根源 更 加 明显 ” 在 写 zeroPad () 时 , 我 们 或 许 想到 将 其 声明 为 公有 的 实用 方法 。 那 样 的 话 ， 
我 们 或 许 会 更 全 面 地 测试 这 个 方法 ,以便 让 其 他 开发 者 知道 怎么 使 用 它 。 我们 也 很 有 可 能 会 考虑 
防止 zeroPad( ) 创 建 不 合法 长 度 的 字符 串 。) 




















此 问题 的 解决 方案 是 , 修复 zeroPad() 中 的 问题 。 也 可 以 改变 encodedDigits(), 使 之 在 得 








到 足够 的 字母 时 ,停止 编码 。 我 们 选择 后 者 : 一 旦 encoding 得 到 编码 ， 就 跳出 循环 。 


> 














c2/26/Soundex.h 

std::string encodedDigits(const std::string& word) const ( 
std::string encoding; 
for (auto letter: word) 


1 
if (encoding.length() == MaxCodelength - 1) break; 
encoding += encodedDigit(letter); 
} 
return encoding; 
} 


新 加 的 代码 不 能 清晰 直接 地 表达 其 意图 。 先 把 它 提 取 为 意图 明确 的 函数 isCompLete() 。 





c2/27/Soundex.h 
std::string encodedDigits(const std::string& word) const ( 
std::string encoding; 
for (auto letter: word) 1 
if (isComplete(encoding)) break; 
encoding += encodedDigit(letter); 
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H 
return encoding; 
} 
» bool isComplete (const std::string& encoding) const { 
» return encoding.length() == MaxCodelength - 1; 
> } 


2.12 ”丢掉 元 音 


规则 1 说 要 丢掉 所 有 的 元 音 以 及 w、h 和 y。 由 于 想不到 更 好 的 名 字 ， 先 称 这 些 字母 为 元 首 类 
字母 。 

c2/28/SoundexTest.cpp 

TEST _F(9oundexEncoding，IgnoresVoweLLikeLetters) { 


ASSERT THAT(soundex.encode("Baeiouhycdl"), Eq("B234")); 

j 

运行 一 下 测试 ， 发 现 还 没 添加 产品 代码 ， 测 试 就 通过 了 。 这 是 由 于 encodedDigit() 对 于 转 
换 表 中 找 不 到 的 字母 会 返回 空 字符 串 。 这样， 所 有 的 元 音 就 被 编码 为 空 字符 串 了 ,并 且 追 加 到 结 
RFP, 

如 果 没 有 改动 类 定义 ， 测 试 就 通过 了 ， 那 背后 肯定 另 有 故事 (参见 3.5 节 )。 可 以 问 自己 一 个 
问题 :“ 我 在 测试 中 做 了 与 期 望 不 一 致 的 事情 吗 ? ” 

如 果 接 下 来 的 测试 也 都 继续 通过 , 那么 应 该 考虑 回 滚 掉 代码 改动 。 测 试 提前 通过 的 原因 ,可 
能 是 你 的 步伐 有 点 大 , 但 这 样 你 可 能 不 会 感受 到 TDD 带 来 的 好 处 。 在 我 们 的 示例 中 , 本 来 可 以 先 
写 一 个 测试 , 演示 该 怎么 应 对 不 能 识别 的 字母 , 这 样 就 可 以 选择 返回 相同 的 字母 , 而 非 空 字符 串 。 












































2.13 ”让 测试 自我 澄清 


下 一 个 测试 是 要 处 理 两 个 相 邻 字母 有 相同 数字 编码 的 情形 。 按 照 规 则 3 ， 将 用 一 个 数字 表示 
这 些 字母 。 这 条 规则 也 适用 于 第 一 个 字母 。 我 们 先 处 理 前 一 种 情形 ， 然 后 再 考虑 后 者 。 















































c2/29/SoundexTest.cpp 


TEST F(SoundexEncoding, CombinesDuplicateEncodings) { 
ASSERT THAT(soundex.encode("Abfcgdt"), Eq("A123")); 
} 


这 个 测试 有 点 让 人 迷糊 ! 为 了 理解 为 什么 Abfcgdt 编 码 为 A123 , RITE AANEREN T 
c 和 g 编 码 为 2，d 和 t 编 码 为 3。 也 可 以 通过 阅读 其 他 测试 ( 如 ReplacesConsonantsWith 
AppropriateDigits ) 来 了 解 这 一 事实 ， 但 或 许 应 该 让 测试 更 加 直接 。 

我 们 添加 一 些 前 置 条 件 ( precondition ) 断言 ， 以 帮助 阅读 代码 的 人 建立 这 种 关联 。 
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c2/30/SoundexTest.cpp 
TEST F(SoundexEncoding, CombinesDuplicateEncodings) 1 


» ASSERT THAT(soundex.encodedDigit('b'), Eq(soundex.encodedDigit('f'))); 
» ASSERT THAT(soundex.encodedDigit('c'), Eq(soundex.encodedDigit('g'))); 
» ASSERT THAT(soundex.encodedDigit('d'), Eq(soundex.encodedDigit('t'))); ERES 


ASSERT THAT(soundex.encode("Abfcgdt"), Eq("A123")); 





} 


前 件 断 言 不 能 通过 编译 , 因为 encodeDigit() 是 私有 成 员 函 数 。 先 简单 把 它 声 明 为 公有 的 成 
PR 


yz 


c2/30/Soundex.h 
» public: 
std::string encodedDigit(char letter) const { 
TA Pe 
} 


> private: 
V ua 


我 感觉 到 读者 的 惊 情 了 。 


提问 : 不 ， 等 一 等 ! 你 不 能 把 私有 函数 改 成 公有 的 。 

回答 : 我 们 也 有 其 他 的 解决 方案 。 可 以 把 测试 代码 作为 Soundex 类 的 友 员 函数 ， 但 
ALLE — AE EAE, 这 一 点 在 TDD 中 也 是 一 样 的 。 可 以 把 这 个 函数 写 到 另 一 
个 类 中 , 壁 如 SoundexDigitEncoder, 但 是 这 似乎 过 度 设 计 了 。 也 可 以 不 要 前 置 条 件 断 言 ， 
而 是 寻找 其 他 的 方法 让 测试 更 具 可 读 性 。 

提问 : 我 们 一 直 被 教导 不 要 暴露 内 部 实现 细节 。 你 不 是 也 应 该 遵守 此 金 科 玉 律 吗 ? 

回答 : 首先 ， 我 们 不 会 随意 暴露 所 有 的 实现 ， 而 只 是 我 们 需要 的 。 其 次 ， 我 们 没有 
暴露 过 多 的 实现 细节 以 至 于 影响 到 Soundex 类 的 公共 接口 。 是 的 ， 我 们 添加 了 一 个 产品 
客户 不 需要 的 函数 ， 但 是 测试 需要 。 所 以 ， 滥 用 的 风险 是 比较 低 的 ， 换 而 得 之 的 是 ， 对 
于 以 后 必须 阅读 测试 的 开发 者 来 说 ， 节 省 了 很 多 时 间 。 


可 以 在 其 他 写 好 的 测试 中 使 用 前 置 条 件 断 言 。 但是， 尽量 不 要 这 样 做 。 通常 ,使 用 名 称 有 意 
义 的 常量 或 局 部 变量 是 一 个 简单 有 效 的 方案 。 此 外 ,试图 加 一 个 前 置 条 件 断 言 ， 可 能 表示 你 错过 
了 男 一 个 测试 。 对 吧 ? 可 以 试 着 添加 一 个 测试 ， 然 后 看 看 它 是 否 消 去 了 对 前 置 条 件 断 言 的 需要 。 

为 了 让 测试 CombinesDuplicateEncodings 通 过 , 可 以 引入 一 个 局 部 变量 , 记录 最 后 一 个 追 
加 的 数字 ,并 在 每 次 循环 迭代 时 更 新 它 。 但 是 光一 个 局 部 变量 似乎 模 楼 两 可 。 我 们 还 是 以 一 个 意 
图 明确 的 声明 开始 。 






















































































c2/31/Soundex.h 


std::string encodedDigits(const std::string& word) const ( 
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std::string encoding; 
for (auto letter: word) 1 
if (isComplete(encoding)) break; 
» if (encodedDigit(letter) !- lastDigit(encoding)) 
encoding += encodedDigit(letter); 


} 

return encoding; 
} 
我 们 知道 lastDigit0 需 要 做 什么 。 稍 微 想 一 想 就 能 找到 一 个 实现 的 方法 。 如 下 : 
c2/31/Soundex.h 


std::string lastDigit(const std::string& encoding) const ( 
if (encoding.empty()) return "" 
return std::string(1, encoding.back()); 





H 
2.14 ”跳出 条 条 框框 来 测试 
现在 考虑 写 下 一 个 测试 , 其 中 第 二 个 字母 和 第 一 个 字母 重复 。 咽 ……… 目前 所 有 测试 都 是 以 一 











个 大 写字 母 开始 ,其 余 字母 是 小 写 , 但 是 这 个 算法 应 该 是 大 小 写 无 关 的 。 让 我 们 稍微 停 一 下 ， 先 
实现 一 些 考虑 大 小 写 的 测试 。( 也 可 以 把 这 个 问题 加 入 到 测试 列表 ， 以 后 再 处 理 。 ) 

没有 指导 怎么 去 处 理 大 小 写 的 规范 , 但 是 TDD 的 好 处 之 一 就 是 , 我 们 可 以 思考 目前 手头 之 外 
的 事情 。 创 建 一 个 健壮 的 应 用 程序 需要 我 们 能 够 处 理 没有 明确 指明 的 关键 要 素 。( 提示 : 可 以 问 
问 你 的 客户 。 ) 

为 了 能 够 快速 、 简 单 地 比较 ，Soundex 算 法 将 类 似 的 词 编码 至 相同 的 代码 。 字 母 的 大 小 写 并 
不 影响 发 音 。 但 为 了 简化 比较 Soundex 编 码 ， 我 们 将 自始至终 使 用 一 样 的 写法 。 


c2/32/SoundexTest.cpp 




































































TEST F(SoundexEncoding, UppercasesFirstLetter) ( 
ASSERT THAT(soundex.encode("abcd"), StartsWith("A")); 
j 


修改 一 下 encode() 中 的 核心 算法 , 将 首 字 母 大 写 , 这 里 我 们 期 待 只 有 一 个 字母 。( upperFront() 
中 的 映射 操作 避免 了 处 理 字符 串 结 束 符 带 来 的 潜在 问题 。) 





























c2/32/Soundex.h 
std::string encode(const std::string& word) const ( 

» return zeroPad(upperFront(head(word)) + encodedDigits(tail(word))); 
} 


> std::string upperFront(const std::string& string) const { 
» return std::string(l, 
» std::toupper(static cast«unsigned char»(string.front()))); 


} 
有 了 对 大 小 写 的 处 理 , 也 促使 我 们 去 修改 测试 IgnoresVowelLikeLetters。 如 上 所 述 , 我 们 期 望 
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算法 代码 可 以 忽略 大 小 写 的 元 音字 母 。 但是, 我们 还 是 想 确认 一 下 。 为 此 ， 更 新 测试 ， 验 证 我 们 
的 想法 。 这 样 看 来 ,我们 从 TDD 跳 转 到 了 事后 测试 的 方式 。 





c2/33/SoundexTest.cpp 


TEST F(SoundexEncoding, IgnoresVowellikeLetters) ( 
» ASSERT THAT(soundex.encode("BaAeEiloOuUhHyYcdl"), Eq("B234")); 
} 


测试 通过 了 , 我 们 可 以 丢掉 刚才 更 新 了 的 测试 。 但 是 为 了 其 他 开发 者 考虑 ,我 们 决定 保留 此 
测试 ， 用 来 显 式 地 文档 化 此 行为 。 
由 于 不 是 很 确定 代码 的 行为 ,我 们 不 得 不 再 写 一 个 测试 。 但 是 当 它 立马 通过 时 , 我 们 觉得 有 
必要 去 审视 一 下 代码 。encodedDigits() 中 的 代码 有 点 隐 了 睡 和 难以 理解 。 我 们 必须 深入 考虑 来 发 
现 以 下 几 点 : 
a 许多 字母 没有 对 应 的 编码 ; 
DencodedDigit() 对 于 上 述 字母 会 返回 空 字 符 串 ; 
口 将 一 个 空 字符 串 和 encodedDigits() 中 的 变量 encodings 连 接 起 来 没有 任何 意义 。 
我 们 重 构 一 下 ， 以 便 代 码 更 加 明了 。 首 先 ， 对 于 一 个 字母 ， 如 果 encodings 表 中 没有 对 应 的 
编码 ，encodedDigit() 将 返回 一 个 名 为 NotADigit 的 常量 。 然 后 , 在 encodedDigits () 中 增加 一 
个 条 件 表达 式 ， 显 式 地 指明 NotADigit 将 被 忽略 。 同 时 ， 我们 也 在 LastDigit() 中 使 用 这 一 常量 。 



























































c2/34/Soundex.h 
> const std::string NotADigit("*"); 


std::string encodedDigits(const std::string& word) const ( 
std::string encoding; 
for (auto letter: word) 1 
if (isComplete(encoding)) break; 


auto digit - encodedDigit(letter); 
if (digit !- NotADigit && digit !- lastDigit(encoding)) 
encoding += digit; 


YvYY 


} 


return encoding; 


} 


std::string lastDigit(const std::string encoding) const { 
> if (encoding.empty()) return NotADigit; 
return std::string(1, encoding.back()); 
} 
[Ly ats 
std::string encodedDigit(char letter) const { 
const std::unordered_map<char, std::string> encodings { 
pau gu cprro P pete ae op 2, 
LT ues 
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auto it = encodings.find(letter); 
» return it == encodings.end() ? NotADigit : it-»second; 


) 

(上 述 代 码 列 出 了 一 些 增 量 重 构 所 做 的 改动 ， 每 次 改动 都 经 测试 验证 通过 。 换 句 话说， 我 们 
并 不 是 一 次 完成 这 些 改动 的 。) 

让 我 们 继续 看 一 个 处 理 辅音 大 小 写 的 测试 吧 ! 























c2/35/SoundexTest.cpp 


TEST F(SoundexEncoding, IgnoresCaseWhenEncodingConsonants) { 
ASSERT THAT(soundex.encode("BCDL"), Eq(soundex.encode("Bcdl"))); 
} 


这 里 的 断言 和 之 前 的 稍微 不 同 。 它 声明 了 对 "BCDL" 和 "Bed1" 的 编码 结果 是 一 样 的 。 也 就 是 
说 ,我 们 并 不 关心 实际 的 编码 是 什么 ， 只 要 大 写 的 输入 和 小 写 的 输入 得 到 的 结果 一 样 就 行 。 


我 们 的 解决 方案 是 在 查询 encodings 表 时 ， 将 字母 全 部 转 为 小 写 (在 encodedDigit() 中 )。 









































c2/35/Soundex.h 


std::string encodedDigit(char letter) const ( 
const std::unordered map«char, std::string» encodings { 
Cbr, 01"), CF, UI, Cp!, "Ih Cv, "1, 


"2 PER 
}; 
> auto it = encodings.find(lower(letter)) 
return it == encodings.end() ? NotADigit : it-»second; 
} 
private: 


char lower(char c) const { 
return std::tolower(static cast«unsigned char>(c)); 


} 


vyy 


2.15 EE 


在 开始 前 一 小 节 时 , 我们 曾 尝试 写 一 个 测试 来 处 理 第 二 个 字母 和 第 一 个 字母 一 样 的 情形 。 这 
又 促使 我 们 先 将 算法 改 为 与 大 小 写 无 关 的 。 现 在 ， 可 以 回 到 最 初 的 目标 ， 继 续 写 这 个 测试 了 。 























c2/36/SoundexTest.cpp 


TEST F(SoundexEncoding, CombinesDuplicateCodesWhen2ndLetterDuplicateslst) { 
ASSERT THAT(soundex.encode("Bbcd"), Eq("B230")); 
} 


我 们 的 解决 方案 会 对 encode() 的 总 体 策 略 稍 作 修改 。 将 整个 词 传 进 encodedDigits ( ) 进 行 编 
码 , 这 样 就 可 以 比较 第 一 个 字母 和 第 二 个 字母 的 编码 了 。 我 们 只 将 编码 的 尾部 追加 到 最 终 的 编码 。 


在 encodedDigits() 内 部 ， 先 将 单词 的 第 一 个 字母 编码 ， 这 样 后 续 的 编码 可 以 与 之 作 比 较 。 
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由 于 encodedDigits() 现 在 是 编码 整个 单词 ， 所 以 我 们 修改 isCompLete() 以 多 容纳 一 个 字母 。 
同时 ， 还 修改 encodedDigits() 中 的 循环 ， 使 之 遍历 整个 单词 的 词尾 。 





c2/36/Soundex.h 


std::string encode(const std::string& word) const ( 
» return zeroPad(upperFront(head(word)) + tail(encodedDigits(word))); 


} 


std::string encodedDigits (const std::string& word) const { 
std::string encoding; 


» encoding += encodedDigit(word.front()); 


» for (auto letter: tail(word)) 1 
if (isComplete(encoding)) break; 


auto digit = encodedDigit(letter); 
if (digit !- NotADigit && digit !- lastDigit(encoding)) 
encoding += digit; 
} 


return encoding; 


} 


bool isComplete (const std::string& encoding) const { 
» return encoding.length() == MaxCodeLength; 
} 


2.16 重 构 至 单一 责任 的 函数 


函数 encodedDigits() 变 得 越 来 越 复杂 。 为 了 将 相关 的 语句 分 组 , 我 们 在 其 间 搬 入 了 一 些 空 
行 。 这 也 揭示 了 此 函数 做 的 事情 大 多 了 。 


单一 责任 原则 (Single Responsibility Principle，SRP ) 告诉 我 们 ， 每 个 函数 的 改动 都 是 基于 
一 个 原因 "。encodedDigits() 是 违反 这 一 原则 的 典型 例子 : 它 把 高 层 的 策略 与 底层 的 实现 细节 
T 8t Tr. 


encodedDigits() 通 过 两 个 步骤 的 算法 完成 其 目的 。 它 首先 将 首 字母 的 编码 追加 至 变量 
encoding 中 ， 然 后 遍历 剩 下 的 字母 ， 追 加 结果 至 encoding。 问 题 是 ，encodedDigits() 中 还 包含 
了 达成 这 两 步 的 一 些 底层 实现 细节 。 此 函数 违背 了 单一 责任 原则 ,因为 有 两 个 原因 会 导致 要 修改 
它 : 想 要 改变 实现 细节 ， 或 需要 改变 整个 编码 策略 。 


可 以 将 encodedDigits() 中 的 两 个 步骤 提取 成 两 个 单独 的 函数 , 每 个 函数 各 自 包 含 一 个 抽象 
概念 的 实现 细节 。 如 此 ，encodedDigits() 中 的 代码 只 是 声明 了 解决 方案 的 策略 。 


















































(D 参见 《人 敏捷 软件 开发 : 原则 、 模 式 与 实践 》 








40 第 2 章 测试 驱动 开发 : 第 一 个 示例 





c2/37/Soundex.h 


std::string encodedDigits(const std::string& word) const ( 
std::string encoding; 
encodeHead(encoding, word); 
encodeTail(encoding, word); 
return encoding; 


} 


void encodeHead(std::string& encoding, const std::string& word) const { 
encoding += encodedDigit(word.front()); 


} 


void encodeTail(std::string& encoding, const std::string& word) const { 
for (auto letter: tail(word)) 1 
if (isComplete(encoding)) break; 


auto digit = encodedDigit(letter); 
if (digit !- NotADigit && digit !- lastDigit(encoding)) 
encoding += digit; 














这 样 看 起 来 好 多 了 。 青 往 前 迈进 一 步 ， 将 encodeTail() 中 的 for 循 环 体 提取 出 来 。 








c2/38/Soundex.h 


void encodeTail(std::string& encoding, const std::string& word) const { 
for (auto letter: tail(word)) 
if (!isComplete(encoding)) 
encodeLetter (encoding, letter); 


} 


void encodeletter(std::string& encoding, char letter) const { 
auto digit - encodedDigit(letter); 
if (digit !- NotADigit && digit !- lastDigit(encoding)) 
encoding += digit; 


} 

从 视觉 上 看 ， 重 构 后 的 代码 还 有 进一步 提升 的 空间 。 对 单个 字母 编码 的 encodeHead () 函数 
是 不 是 encodeTaitL() 中 编码 的 一 个 特例 呢 ? 尽管 去 试验 吧 ! 因为 有 了 测试 的 保证 ， 所 以 你 所 做 
的 事情 将 是 安全 的 。 目 前 而 言 ， 我 们 觉得 算法 的 实现 已 经 足够 清楚 ， 所 以 继续 吧 ! 
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2.17 ”收尾 工作 
那 元 音 怎么 办 呢 ? 规则 3 说 被 一 个 元 音 (不 是 h 或 w ) 分 开 的 相同 编码 ， 应 该 编码 两 次 。 

















c2/39/SoundexTest.cpp 


TEST F(SoundexEncoding, DoesNotCombineDuplicateEncodingsSeparatedByVowels) { 
ASSERT THAT(soundex.encode("Jbob"), Eq("J110")); 


} 
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再 一 次 通过 声明 要 完成 的 目标 来 解决 问题 。 我 们 修改 了 encodeLetter() 中 的 条 件 表 达 式 ， 
在 不 是 重复 编码 或 最 后 一 个 字母 是 元 音 的 情况 下 , 追加 一 个 数字 。 这 个 声明 也 敦促 了 一 些 其 他 的 
相应 改动 。 




















c2/39/Soundex.h 

void encodeTail(std::string& encoding, const std::string& word) const { 
» for (auto i = lu; i < word.length(); i++) 
» if (!isComplete(encoding)) 
» encodeletter(encoding, word[il], word[i - 1]); 


} 


» void encodeletter(std::string& encoding, char letter, char lastLetter) const { 
auto digit = encodedDigit(letter); 
if (digit !- NotADigit && 
» (digit != lastDigit(encoding) || isVowel(lastLetter))) 
encoding += digit; 


} 


bool isVowel(char letter) const { 
return 
std: :string('aeiouy’).find(lower(letter)) != std::string: :npos; 


YYVYN 


} 


把 最 后 一 个 字母 传人 isVowel () 中 是 最 好 的 方法 吗 ? 不 过 , 这 个 方法 直接 且 具 有 表达 力 。 我 
们 暂时 先 这 样 做 。 
































2.18 漏 了 什么 测试 吗 


我 们 很 少 拥有 所 有 的 规范 。 很 少 有 人 会 如 此 幸运 。 即 便 是 Soundex 的 规则 ， 看 似 完整 ， 实 际 

却 不 能 蕴含 所 有 情形 ,在 编程 过 程 中 ,一 些 测试 或 代码 实现 经 常会 激发 我 们 进行 其 他 方面 的 思考 。 

般 而 言 , 要 么 把 这 些 思考 结果 记 在 脑子 里 , 要 人 么 写 到 一 个 列表 或 记事 本 中 。 下面 就 是 对 Soundex 
进行 思考 而 得 到 的 列表 。 


a 若 给 定 的 词 中 含有 分 隔 符 ， 如 句点 A, Mr.Smith), EAI? 应 该 忽略 它们 ( 就 像 
现在 做 的 这 样 )， 抛 出 一 个 异常 ( 假定 客户 应 该 把 词 合 理 地 分 好 )， 还 是 做 些 其 他 操作 ? 
说 到 异常 ， 怎 样 以 测试 驱动 的 方法 在 代码 中 加 入 异常 处 理 ? 在 4.4.5 节 中 ， 你 将 学 到 怎样 
设计 期 望 抛 出 异常 的 测试 。 

O 空 字符 串 该 怎样 编码 ?( 或 者 说 ， 可 以 假定 不 会 接收 到 一 个 空 字 符 串 输入 吗 ? ) 

Q 该 怎样 处 理 非 英语 字母 中 的 辅音 ( 如 站 ) ? Soundex 算 法 依然 适用 吗 ?” isVowel() 函数 需要 
支持 带 变 音符 的 元 音 吗 ? 


许多 这 样 的 考虑 对 于 设计 一 个 健壮 的 Soundex 类 至 关 重 要 。 若 未 能 处 理 好 它们 ， 在 实际 使 用 
中 ， 应 用 程序 可 能 会 失效 。 
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对 于 诸如 此 类 的 问题 , 我 们 其 实 没 有 确切 的 答案 。 作 为 程序 员 , 我 们 应 该 已 经 学 会 适时 作出 
自己 的 决定 。 但 往往 更 好 的 方法 就 是 去 问 客户 , 甚至 可 以 和 他 们 一 起 制定 验收 测试 ( 参见 10.3 节 )。 

“系统 应 该 按照 A 来 做 , 还 是 按照 B 来 做 ? ”以 往 而 言 , 我 们 会 直接 把 选择 代码 化 , 然后 继续 。 
这 样 做 的 后 有 果 是 ， 未 能 及 时 将 我 们 作出 的 决定 写 入 文档 。 有 了 时， 解决 方案 B 可 能 会 被 夹杂 在 一 大 
堆 其 他 代码 中 。 当 然 ， 可 以 分 析 代 码 来 确定 我 们 作出 了 什么 选择 , 但 这 通常 很 耗 时 。 相 信 我们 都 
曾经 花 过 无 数 小 时 试图 判定 代码 的 行为 吧 ! 

相反 ，TDD 留 下 了 一 份 清晰 的 文档 。 我 们 可 以 毫 不 费力 地 回忆 起 数 月 前 作出 的 决定 。 


和 迄今 为 止 所 做 的 一 样 , 我 们 可 以 采用 TDD 方 式 为 前 面 提 出 的 几 个 问题 开发 解决 方案 。 这 些 
漏 掉 的 测试 就 留 给 读者 作为 练习 吧 ! 

















2.19 ”解决 方案 


我 们 用 测试 驱动 方法 开发 出 了 Soundex 的 解决 方案 。 这 个 解决 方案 绝 不 是 唯一 的 或 最 好 的 ， 
但 是 我 们 有 足够 的 信心 去 发 布 了 (除了 2.18 小 节 提 及 的 一 些 未 解 问 题 )， 这 才 是 最 重要 的 。 


我 自己 对 Soundex 做 了 好 几 次 测试 驱动 开发 ， 每 次 都 得 到 不 同 的 解决 方案 。 其 中 大 部 分 解决 
方案 的 差异 很 小 ,但 有 一 个 差异 很 大 ( 而 且 工 作 起 来 很 糟糕 )， 这 是 由 我 积极 地 以 极 具 描述 性 的 
方式 来 解决 问题 而 导致 的 。 每 一 次 Soundex TDD 经 历 都 让 我 更 好 地 了 解 此 算法 ， 与 此 同时 ， 我 也 
学 会 了 更 多 可 以 在 TDD 中 很 好 地 工作 的 东西 。 


多 次 测试 驱动 开发 Soundex 算 法 后 ， 你 会 发 现 类 似 的 好 处 。 重 复 使 用 TDD 方 法 去 开发 同一 个 
示例 可 称 为 套路 (kata )。 参 见 11.5 节 ， 以 了 解 更 多 相关 信息 。 


任何 解决 方案 的 实现 并 非 仅 有 一 种 正确 的 方式 ,下面 是 一 个 解决 方案 应 具备 的 一 些 重 要 特征 。 


口 它 实 现 了 客户 的 需求 。 如 果 没 有 ,那么 不 管 怎样 ， 它 都 不 是 好 的 解决 方案 。 在 TDD 中 ， 
你 编写 的 测试 能 够 帮助 你 了 解 你 的 解决 方案 是 不 是 客户 要 的 。 性 能 可 能 是 众多 客户 需求 
中 的 一 项 。 你 的 一 部 分 职责 就 是 理解 他 们 的 性 能 需求 ， 如 果 没 必要 的 话 ， 就 不 要 花费 时 
间 去 做 性 能 优化 。 

a 它 可 以 工作 。 如 果 一 个 解决 方案 有 大 量 的 缺陷 ,那么 构建 得 再 优雅 ， 也 不 是 好 的 解决 方 
案 。TDD 可 以 帮助 确定 我 们 交付 的 软件 能 以 期 望 的 方式 工作 。TDD 不 是 银 弹 "。 你 交付 的 
软件 依然 会 有 缺陷 ， 所 以 照样 需要 许多 其 他 方式 的 测试 。 但 是 ，TDD 会 让 你 发 布 的 代码 
包含 非常 少 的 缺陷 。 
















































































































































































中 银 弹 ( Silver Bullet ) 是 欧洲 民间 传说 中 用 来 对 付 怪物 的 杀手 铀 武器 ， 后 来 银 弹 经 常 被 比喻 为 一 种 非常 有 效 的 解决 
方案 。Frederick 在 1987 年 的 IFIPS 会 议 上 发 表 了 题 为 "No Silver Bullet, Essense and Accidents of Software Engineering" 
的 论文 。 由 于 这 篇 论文 引发 了 剧烈 的 的 争论 ， 后 来 Frederic 在 《人 月 神话 》 一 书 中 对 一 些 公开 的 批评 做 了 说 明 ， 并 
更 新 了 论文 中 的 一 些 观点 ， 有 兴趣 的 读者 可 以 找 来 看 看 。 一 一 译 者 注 
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口 它 易于 理解 。 对 于 编写 得 不 好 的 代码 ， 每 个 人 都 需要 花费 大 量 的 时 间 去 理解 。TDD 让 你 
可 以 安全 地 重新 组 织 代 码 以 提高 可 读 性 。 
口 它 易 于 修改 。 通 常 ， 容 易 修改 的 代码 意味 着 高 质量 的 设计 。TDD 使 你 可 以 持续 地 修改 ， 
以 保持 设计 的 高 质量 。 
我 们 的 解决 方案 不 是 过 程式 的 。 避 bs uM d 二 相反 ， 
我 们 以 许多 小 的 成 员 函 数 的 方式 完成 整体 实现 , 许多 函数 只 行 代码 。 每 个 函数 的 代码 实现 
o s astu Ada H sur Ba CET 
为 什么 以 这 样 的 方式 实现 ， 参 见 6.2 节 。) 





























2.20 Soundex 类 


因为 已 准备 好 提交 代码 , 所 以 让 我 们 来 纵览 一 下 整个 解决 方案 。 我 们 觉得 还 没有 足够 的 理由 
去 单独 拆 分 出 实现 文件 〈.cpp )， 但 是 这 是 成 为 系统 产品 代码 所 必需 的 一 步 。 














c2/40/SoundexTest.cpp 


#include "gmock/gmock.h" 
#include "Soundex.h" 
using namespace testing; 


class SoundexEncoding: public Test ( 
public: 
Soundex soundex; 


}; 


TEST F(SoundexEncoding, RetainsSoleLetterOfOneLetterWord) { 
ASSERT THAT(soundex.encode("A"), Eq("A000")); 
} 


TEST F(SoundexEncoding, PadsWithZerosToEnsureThreeDigits) { 
ASSERT THAT(soundex.encode("I"), Eq("I000")); 
} 


TEST_F(SoundexEncoding, ReplacesConsonantsWithAppropriateDigits) { 
ASSERT THAT(soundex.encode("Ax"), Eq("A200")); 
} 


TEST_F(SoundexEncoding, IgnoresNonAlphabetics) { 
ASSERT THAT(soundex.encode("AZ"), Eq("A000")); 
} 


TEST F(SoundexEncoding, ReplacesMultipleConsonantsWithDigits) { 
ASSERT THAT(soundex.encode("Acdl"), Eq("A234")); 
} 


TEST_F(SoundexEncoding, LimitsLengthToFourCharacters) { 
ASSERT THAT(soundex.encode("Dcdlb").length(), Eq(4u)); 
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TEST_F(SoundexEncoding, IgnoresVowelLikeLetters) { 
ASSERT THAT(soundex.encode("BaAeEiloOuUhHyYcdl"), Eq("B234")); 
} 


TEST_F(SoundexEncoding, CombinesDuplicateEncodings) { 
ASSERT THAT(soundex.encodedDigit('b'), Eq(soundex.encodedDigit('f'))); 
ASSERT THAT(soundex.encodedDigit('c'), Eq(soundex.encodedDigit('g'))); 
ASSERT THAT(soundex.encodedDigit('d'), Eq(soundex.encodedDigit('t'))); 


ASSERT THAT(soundex.encode("Abfcgdt"), Eq("A123")); 


TEST F(SoundexEncoding, UppercasesFirstLetter) ( 
ASSERT THAT(soundex.encode("abcd"), StartsWith("A")); 
} 


TEST F(SoundexEncoding, IgnoresCaseWhenEncodingConsonants) { 
ASSERT THAT(soundex.encode("BCDL"), Eq(soundex.encode("Bcdl"))); 
} 


TEST F(SoundexEncoding, CombinesDuplicateCodesWhen2ndLetterDuplicateslst) { 
ASSERT THAT(soundex.encode("Bbcd"), Eq("B230")); 


TEST F(SoundexEncoding, DoesNotCombineDuplicateEncodingsSeparatedByVowels) { 
ASSERT THAT(soundex.encode("Jbob"), Eq("J110")); 
} 


c2/40/Soundex.h 


#ifndef Soundex h 
define Soundex h 


#include «string» 
#include «unordered map» 


#include "CharUtil.h" 
#include "StringUtil.h" 


class Soundex 
1 
public: 
static const size t MaxCodeLength(4) ; 


std::string encode(const std::string& word) const ( 
return stringutil::zeroPad( 
stringutil::upperFront(stringutil::head(word)) + 
stringutil::tail(encodedDigits(word)), 
MaxCodeLength); 
J 


std::string encodedDigit(char letter) const { 
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const std::unordered map«char, std::string» encodings ( 
Ub, "1", CF, CI, Cp!, 1), Cv, "1"), 
Uc, 27, Cg, "272, Cp, "27, CK, "27, (qi, 727, 
(st 027), Cx, 279, Czh, 2"), 
i 





['u^, ta {ty 420, 
CU, "4"), 
Un, "5th inns") 
E 
}; 
auto it = encodings.find(charutil::lower(letter)); 
return it == encodings.end() ? NotADigit : it-»second; 
} 
private: 


const std::string NotADigit{"*"}; 


std::string encodedDigits (const std::string word) const { 
std::string encoding; 
encodeHead (encoding, word); 
encodeTail(encoding, word); 
return encoding; 


) 


void encodeHead(std::string& encoding, const std::string& word) const { 
encoding += encodedDigit(word.front()); 


} 


void encodeTail(std::string& encoding, const std::string& word) const { 
for (auto i = lu; i < word.length(); i++) 
if (!isComplete(encoding)) 
encodeLetter (encoding, word[i], word[i - 1]); 
} 
void encodeletter(std::string& encoding, char letter, char LastLetter) const { 
auto digit = encodedDigit(letter); 
if (digit !- NotADigit && 
(digit !- lastDigit(encoding) || charutil::isVowel(lastLetter))) 
encoding += digit; 


H 


std::string lastDigit(const std::string& encoding) const { 
if (encoding.empty()) return NotADigit; 
return std::string(1, encoding.back()); 


H 


bool isComplete(const std::string& encoding) const { 
return encoding.length() == MaxCodeLength; 
} 
}; 


#endif 


等 等 , 有些 东西 已 经 变 了 1 head()、tail() 和 zeroPad() 在 哪 ? isVowel() 和 upper() 呢 ? 
lastDigit() 看 起 来 也 不 同 了 ! 
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哈哈 ! 当 你 忙于 阅读 本 书 的 时 候 , 我 做 了 额外 的 一 些 重 构 工作 。 这 些 消失 的 浮 数 《 原先 定义 
在 Soundex 中 ) 现在 被 作为 自由 函数 声明 在 StringUtil.h 和 CharUtit.h 中 。 通过 这 个 小 的 重 构 ， 
它们 成 了 高 度 可 重用 的 函数 。 

简单 地 将 这 些 函 数 从 Soundex 中 移 除 还 不 够 。 作 为 公用 的 工具 孔 数 ， 它 们 需要 恰当 的 描述 ， 
以 便 其 他 程序 员 能 够 理解 它们 的 意图 和 用 法 。 这 也 就 意味 着 , 需要 一 些 测试 告诉 程序 员 如 何在 代 
码 中 使 用 这 些 函 数 。 可 以 在 本 书 的 源 代码 中 找到 这 些 工 具 函 数 及 它们 的 测试 。 


我 们 用 测试 驱动 方法 开发 出 了 Soundex 的 一 种 解决 方案 。 这 个 方案 的 演化 完全 取决 于 你 。 你 
越 多 地 践 行 TDD, 你 的 解决 方案 风格 也 就 演变 得 越 多 。 两 年 前 测试 驱动 开发 出 的 结果 和 我 今天 测 
试 开发 出 的 结果 有 着 天 壤 之 别 。 












































2.21 结束语 


本 章 中 , 你 亲身 经 历 了 一 个 实际 的 TDD 过 程 。 你 是 自己 编写 代码 的 吗 ? 如 果 是 ,你 已 经 实现 
了 一 个 几乎 可 以 在 产品 代码 中 使 用 的 Soundex 类 。 如 果 不 是 ,打开 编辑 器 去 实现 Soundex 类 吧 ! 通 
过 写 代 码 学 习 比 简单 阅读 代码 更 有 效 。 

准备 好 真正 去 学 TDD 了 吗 ? 再 次 出 发 ! 再 一 次 测试 驱动 开发 Soundex 类 ， 但 这 次 不 要 阅读 本 
章 ( 除非 遇 到 困难 )。 以 不 同 顺序 实现 Soundex 规 则 会 发 生 什么 呢 ? 采用 不 同 的 编程 风格 又 会 怎样 
呢 ? 如 果 每 个 规则 都 用 一 个 函数 变换 输入 ， 然 后 把 它们 串 起 来 作为 Soundex 的 实现 ， 结 果 又 会 如 
何 呢 ? 


如 果 你 准备 好 继续 学 习 了 ,下 一 章 会 以 整体 的 视角 审视 TDD。 它 介绍 了 TDD 的 一 些 基本 和 定义， 
并 提供 了 为 取得 成 功 所 需要 的 战略 和 战术 性 建议 。 
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3.1 开场 白 


上 一 章 中 的 详实 示例 展示 了 TDD 在 实践 中 的 样子 。 在 完成 示例 的 过 程 中 , 我 们 接触 到 了 很 多 
概念 和 良好 的 实践 准则 。( 如 果 你 已 经 熟悉 TDD ,或 许 跳 过 了 上 一 章 。) 本 章 将 深入 讨论 这 些 主题 ， 
介绍 更 多 的 背景 知识 及 其 背后 的 因果 关系 。 

口 单元 的 定义 
DTDD 的 周期 : 红 - 绿 - 重 构 
口 TDD 的 三 条 准则 

口 为 什么 不 要 忽略 测试 失败 
口 成 功 的 思维 

口 成 功 的 方法 


在 学 习 过 上 述 主题 后 ， 你 将 在 TDD 流 程 和 概念 方面 打下 坚实 的 基础 。 
































3.2 ”单元 测试 和 测试 驱动 开发 基础 知识 


TDD 会 产 出 单元 测试 。 单元 测试 验证 了 一 个 代码 单元 的 行为 , 这 里 的 代码 单元 是 一 个 应 用 中 
最 小 的 、 可 测 的 一 段 代码 。 通 常 而 言 ， 开 发 单元 测试 和 代码 单元 要 使 用 一 致 的 编程 语言 。 





3.2.1 单元 测试 的 组 织 和 执行 
单元 测试 包括 一 个 描述 性 的 名 称 和 一 系列 代码 声明 , 从 概念 上 可 以 细 分 成 四 个 ( 有 序 的 ) 部 分 : 
(1) 设置 能 够 运行 上 下 文 的 语句 ， 这 一 部 分 是 可 选 的 ; 
Q) 一 条 或 多 条 能 构成 你 想 要 验证 的 行为 的 语句 ; 
(3) 一 条 或 多 条 验证 期 望 输出 的 语句 ; 
(4) 清理 工作 的 语句 ( 例如， 释放 所 分 配 的 内 存 )， 这 一 部 分 是 可 选 的 。 
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有 些 开 发 者 把 前 三 部 分 称 为 Given-When-Then。 换 言 之 就 是 给 定 一 个 上 下 文 ， 执 行 测试 ， 继 
而 验证 行为 。 还 有 一 些 开 发 者 称 之 为 Arrange-Act-Assert ( 参见 第 4 章 )。 

一 般 来 说 ， 我 们 会 将 关联 的 测试 组 织 到 一 个 源 文件 中 。 和 大 多 数 单元 测试 工具 一 样 ， 使 用 
Google Mock 可 以 将 单元 测试 按 逻 辑 分 组 到 fixture 中 。 你 可 以 给 每 个 TDD 的 类 配 一 个 fixture, 但 是 
也 不 要 拘泥 于 此 形式 。 一 个 C++ 类 对 应 多 个 fixture, 或 一 个 fixture 测 试 多 个 类 中 相关 联 的 行为 , 这 
都 是 很 常见 的 。 参 见 第 4 章 了 解 更 多 的 信息 。 


可 以 选择 众多 可 用 的 C++ 单元 测试 工具 中 的 一 个 来 执行 单元 测试 。 尽 管 这 些 工具 大 部 分 都 很 
相似 ， 但 并 没有 一 个 通用 的 标准 。 所 以 ,不 能 直接 在 各 个 工具 间 移 植 C++ 单 元 测试 。 每 个 工具 都 
定义 了 不 同 的 规则 ， 诸 如 组 织 测 试 的 方式 、 断 言 的 形式 ， 以 及 执行 测试 的 方式 。 

我 们 把 执行 一 遍 所 有 的 测试 称 为 运行 测试 (testrun 或 suite run )。 在 运行 测试 的 过 程 中 , 工具 
会 枚 举 所 有 的 测试 , 独立 地 执行 每 个 测试 。 对 于 每 个 测试 来 说 , 测试 工具 都 是 从 头 到 尾 执行 其 中 
的 语句 的 。 当 执行 一 条 断言 语句 时 ， 如 果断 言 所 期 待 的 条 件 不 满足 ， 那 么 测试 就 会 失败 。 反 之 ， 
测试 通过 。 

单元 测试 实践 方式 多 种 多 样 , 测试 的 粒度 也 各 异 。 大 多 数 开 发 者 编写 单元 测试 (但 不 一 定 在 
使 用 TDD ) 仅 仅 为 了 使 用 工具 提供 的 验证 功能 .通常 这 些 开 发 者 在 完成 产品 的 一 个 功能 部 分 之 后 ， 
就 会 去 编写 相应 的 测试 。 由 于 开发 人 员 没 有 以 测试 的 思维 去 写 测 试 , 因此 很 难 去 编写 和 维护 这 些 
后 于 开发 的 测试 。 而 我 们 将 使 用 TDD， 并 且 会 做 得 更 好 。 

















































































































3.2.2. ”测试 驱动 单元 


与 plain ol' unit testing ( POUT ) “不同 ，TDD 是 一 个 定义 更 加 简明 的 流程 ， 并 且 也 使 用 了 单 
元 测试 。 但 在 TDD 中 , 我 们 会 先 写 测试 ,并 且 保 持 测试 的 粒度 尽量 小 上 且 一 致 ， 这 样 做 会 有 许多 好 
处 ， 甚 中 最 重要 的 就 是 可 以 安全 地 修改 现 有 代码 。 

在 TDD 中 , 你 是 以 非常 小 的 步伐 , 增 量 地 往 系统 中 添加 新 行为 。 换 句 话说 ,为 了 往 系统 中 加 
入 新 的 行为 , 首先 你 会 去 写 一 个 测试 来 定义 这 个 行为 。 这 个 起 初 运行 失败 的 测试 将 驱使 你 去 实现 
相应 的 行为 。 

“非常 小 ? ”事实 上 并 没有 一 个 标准 的 大 小 限制 ， 所 以 你 需要 采用 一 个 适当 的 大 小 。 每 个 测 
试 应 当代 表 你 能 想到 的 最 小 的 、 有 意义 的 增 量 。 测试 最 好 包含 一 到 三 行 代码 ( 参见 4.2.4 节 ) 和 一 
个 断言 (参见 7.3 节 )。 当 然 ， 也 会 有 许多 代码 比较 多 的 测试 ， 这 没关系 ， 但 坚持 “适当 ”的 原则 
会 提醒 你 反 过 来 思考 测试 的 大 小 ， 即 这 些 测 试 是 不 是 做 得 太 多 了 ? 

仅 需 几 分 钟 就 可 以 写 好 包含 三 行 以 内 语句 及 一 个 断言 语句 的 测试 , 同时 仅仅 需要 几 分 钟 就 可 
实现 对 应 的 行为 , 一 个 断言 可 以 验证 的 代码 有 多 少 呢 ? 这 些 为 运行 失败 测试 而 加 入 到 系统 中 的 相 


































































































CD 这 里 指 的 是 在 代码 开发 完成 后 再 编写 测试 的 情况 。 一 一 译 者 注 
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关 小 代码 段 被 称 为 逻辑 分 组 ， 或 代码 单元 。 

不 要 写 履 盖 大 量 功能 的 测试 。 应 将 此 类 测试 放 在 别处 ， 或 许 作为 验收 测试 (客户 测试 ) RA 
统 测试 。 本 书 把 这 种 为 集成 代码 准备 的 测试 称 作 和 集成 测试 (参见 10.3 节 )。 集 成 测试 验证 的 代码 
必须 与 其 他 代码 或 外 部 实体 (文件 系统 、 数 据 库 、 网 络 协议 和 其 他 API ) 集成 。 相 反 ， 你 可 以 使 
用 单元 测试 独立 地 验证 代码 单元 。 

我 们 可 以 从 TDD ( 参见 3.4 节 ) 的 第 一 条 原则 得 知 ， 只 在 让 失败 测试 通过 时 才 编 写 产品 代码 。 
为 了 遵循 这 条 原则 , 你 就 不 可 避免 地 需要 开发 与 外 部 实体 交互 的 代码 。 这 样 做 又 把 你 引 向 集成 测 
ik, 但 是 没关系 。TDD 并 不 阻止 你 这 么 做 。 不 要 太 在 意 术语 上 的 不 同 。 重 要 的 是 先 指定 行为 ， 系 
统 地 测试 驱动 开发 系统 中 的 每 一 块 代码 。 

我 们 将 在 第 5 章 学 习 怎 样 利 用 测试 替身 切断 对 外 部 实体 的 依赖 。 这 样 一 来 ， 天 生 执行 较 慢 的 
集成 测试 将 演化 为 快速 执行 的 单元 测试 。 



























































3.3 ”测试 驱动 开发 周期 : 红 - 绿 - 重 构 
在 做 测试 驱动 开发 时 ， 要 重复 以 下 简短 的 周期 : 
(1) 写 一 个 测试 (“ 红 ”); 

Q) 让 测试 通过 (“ 绿 ” ); 
(3) 优化 设计 (“ 重 构 ” )。 





~ 


2 
€ 





这 个 周期 通常 被 称 为 : 红 - 绿 - 重 构 ， 这 来 源 于 TDD 中 使 用 的 单元 测试 工具 。 红 ( 失败 ) 和 绿 
(通过 ) 来 源 于 SUnit (第 一 个 支持 TDD 的 单元 测试 工具 ”) 和 类 似 的 GUI 工具 ,这些 工具 用 颜色 提 
供 测 试 结果 的 快速 反馈 。Google Mock 以 文本 方式 输出 ， 如 果 终 端 支持 颜色 输出 ， 也 会 使 用 红 和 
绿 表示 测试 结果 。 


在 重 构 阶 段 ， 要 确保 代码 库 有 尽 可 能 最 好 的 设计 , 这 让 你 能 够 以 合理 的 开销 去 扩展 和 维护 系 











(D http:;//sunit.sourceforge.net 
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统 。 当 你 想 在 不 改变 代码 行为 的 情况 下 改进 设计 时 , 则 需要 重 构 ( 这 一 术语 因 Matrin Fowler 的 《 重 
构 : 改善 既 有 代码 的 设计 》 而 普及 )， 而 有 了 测试 的 保障 ， 重 构 就 能 安全 地 进行 。 人 参见 第 6 章 获取 
更 多 信息 。 


思考 和 测试 驱动 开发 


将 TDD 的 周期 记 在 脑海 里 的 目的 是 让 你 适应 两 件 事 。 
二 , 每 个 周期 都 要 清理 代码 。 养 成 这 一 习惯 会 使 你 的 思想 
方案 中 更 具 挑 战 性 的 问题 。 

在 TDD 周 期 中 的 每 一 步 ， 你 必须 能 够 回答 以 下 问题 。 


a 写 一 个 小 的 测试 。 怎 样 才 算 可 以 增 量 开发 的 最 小 行为 呢 ? ( 参见 3.7 节 ) 系统 中 已 经 存在 
这 样 的 行为 了 吗 ? 怎样 让 测试 名 称 准确 表达 行为 ? 测试 中 使 用 的 接口 是 客户 端 代 码 使 用 
这 一 行为 的 最 好 方式 吗 ? 

口 确保 新 的 测试 是 失败 的 。 如 果 没 有 失败 ， 为 什么 ”这 个 行为 已 经 在 系统 中 存在 了 ? 你 忘 

记 编 译 了 吗 ? 是 不 是 在 上 个 测试 中 步子 迈 大 了 ? 断言 是 否 有 效 ? 

a 写 出 你 认为 可 以 让 测试 通过 的 代码 。 你 写 的 代码 是 不 是 刚好 满足 测试 说 明 的 行为 要 求 ? 

你 清楚 刚才 写 的 代码 中 哪些 地 方 需要 整理 吗 ? 你 遵循 团队 的 标准 了 吗 ? 

OQ 确保 所 有 测试 都 能 通过 。 如 果 没 有 ， 你 的 编码 正确 吗 ? 或 是 你 的 规范 正确 吗 ? 

口 整理 刚才 的 代码 改动 。 怎 么 做 才能 让 你 的 代码 符合 团队 标准 ?新 的 代码 和 系统 中 其 他 要 
清除 的 代码 有 重复 吗 ? 代码 有 没有 坏 味 ? 遵循 好 的 设计 原则 了 吗 ? 除了 当下 要 做 的 设计 
和 代码 整理 工作 ， 你 还 知道 其 他 什么 ”设计 是 朝 好 的 方向 发 展 吗 ? 你 的 代码 改动 会 导致 
需要 修改 其 他 地 方 的 代码 吗 ? 

OQ 确保 所 有 测试 再 次 通过 。 确 信 你 的 单元 测试 覆盖 率 够 高 吗 ? 你 是 不 是 应 该 运行 一 些 速 
较 慢 的 测试 集合 ， 以 便 有 信心 继续 前 行 ? 下 一 个 测试 是 什么 ? 


本 书 中 包含 大 量 帮助 你 解决 这 些 问 题 的 信息 。 


在 一 天 的 开发 工作 中 , 你 时 常 需要 思考 大 量 的 东西 。 虽 然 TDD 周 期 很 简单 , 但 是 构建 产品 级 
代码 却 非 易 事 。 践 行 TDD 绝 非 无 意识 的 练习 。 




















第 一 ,你 需要 写 一 个 测试 说 明 行 为 。 第 
到 解放 , 进而 去 思考 在 增 量 开 发 解决 
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3.4 测试 驱动 开发 的 三 条 准则 
Robert C. Martin ( Bob 大 叔 ) 提出 了 上 践 行 TDD 的 简明 规则 ?"。 


(1) 只 在 让 失败 测试 通过 时 才 编 写 产 品 代码 。 
(D 当 测 试 刚 好 失败 时 ， 停 止 继续 编写 。 编 译 失败 也 是 失败 。 




















OD http://butunclebob.com/ArticleS.UncleBob.TheThreeRulesOfTdd 
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(3) 只 编写 能 刚好 证 一 个 失败 测试 通过 的 产品 代码 。 
规则 1 是 说 先 写 一 个 测试 。 用 单元 测试 的 方式 来 理解 和 说 明 必 须要 加 入 到 系统 中 的 行为 。 


规则 2 是 说 尽量 增 量 地 前 进 。 你 可 以 在 每 写 一 行 代 码 后 ， 继 续 写 下 一 行 代 码 之 前 ， 得 到 一 些 
反馈 信息 ( 通过 编译 或 运行 测试 )。 


我 们 需要 在 测试 驱动 开发 RetweetCollection 类 并 写 完 第 一 个 测试 时 立刻 停 下 来 。 

















c3/1/RetweetCollectionTest.cpp 
#include "gmock/gmock.h" 


TEST(ARetweetCollection, IsEmptyWhenCreated) { 
RetweetCollection retweets; 


} 

我 们 还 没 定义 RetweetCollection 类 ， 所 以 我 们 知道 这 行 测试 代码 不 能 编译 通过 。 这 时 就 需要 
写 一 些 代码 来 定义 这 个 类 ,重新 编译 ， 直 到 通过 为 止 。 只 有 到 这 一 步 , 我们 才能 去 写 一 个 断言 来 
验证 集合 是 空 的 。 
规则 2 是 存 有 争议 的 ， 它 还 没有 作为 TDD 标 准 被 广泛 接受 。 在 C++ 中 ， 如 果 编 译 时 间 过 长 ， 
这 样 做 可 能 会 降低 效率 。 你 可 能 觉得 先 完成 整个 测试 效率 会 更 高 。 但是， 在握 弃 此 规则 前 ,还 是 
先 老 老实 实地 遵守 ( 作为 一 个 TDD 的 实践 者 ， 我 会 按时 所 需 地 遵循 此 规则 )。 
规则 3 说 不 要 写 多 于 测试 规定 的 代码 。 这 也 是 规则 1 说 “让 失败 测试 通过 ”的 原因 。 如 果 你 写 
的 代码 多 于 需要 的 (例如 你 实现 了 一 个 没有 测试 对 应 的 行为 )， 就 违反 了 规则 1， 因 为 你 在 这 之 后 
写 的 测试 可 能 会 立刻 运行 通过 。 

有 时候 你 会 发 现 , 在 掌握 测试 驱动 开发 过 程 中 ， 先 写 一 个 失败 的 测试 是 非常 困难 的 (下 一 节 
将 会 进一步 讨论 这 个 问题 )。 


学 习 时 遵循 这 些 规 则 有 助 于 你 日 后 理解 一 些 会 破坏 它们 的 潜在 因素 。 


























































































































3.5” 表 里 不 一 


TDD 的 第 一 条 规则 要 求 在 写 代 码 前 ， 先 写 出 一 个 运行 失败 的 测试 。 从 逻辑 上 讲 , 这 是 一 个 可 
以 遵守 的 简单 规则 。 如 果 你 写 的 代码 仅仅 能 让 一 个 测试 通过 , 那么 针对 额外 功能 的 测试 自然 会 失 
败 。 但 实际 上 ， 有 时 你 会 发 现 刚 刚 写 完 的 一 个 测试 立刻 就 通过 了 。 我 将 这 种 非 期 望 事件 称 为 提前 
通过 ( premature passes )。 

下 列 原因 可 能 会 让 测试 提前 通过 : 

口 运行 了 错误 的 测试 
口 测试 了 错误 的 代码 
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口 不 当 的 测试 规范 
口 对 系统 的 无 效 假设 
口 不 佳 的 测试 顺序 
口 相关 联 的 产品 代码 
口 过 度 编码 

口 确定 性 测试 




















3.5.1 运行 了 错误 的 测试 

当 我 们 静 下 心 来 ， 要 做 的 第 一 件 事 就 是 运行 测试 集 。 你 有 多 少 测试 ” 每 当 你 新 加 一 个 测试 ， 
都 会 焦急 地 等 待 测试 运行 后 显示 的 测试 数目 。“ 咽 …… 为 什么 我 的 测试 过 了 ? 我 应 该 有 43 个 测 
试 ， 但 是 现在 只 运行 了 42 个 。 这 次 运行 的 测试 不 包含 我 的 新 测试 。 

跟踪 测试 数目 有 助 于 你 快速 判断 是 不 是 犯 了 以 下 思春 的 错误 : 
口 运行 了 错误 的 测试 集 ; 
口 Google Mock 过 滤 右 忽略 了 新 的 测试 ( 参见 4.3 节 ); 
口 测试 并 没有 经 过 编译 或 链接 ; 
口 测试 被 禁止 了 (参见 3.7 节 )。 

如 果 没 有 第 一 时 间 发 现 测试 失败 ,那么 问题 会 变 得 更 糟 。 试想 你 写 完 一 个 测试 ， 跳 过 运行 测 
试 集 这 一 环节 ， 继 续 写 代码 ， 然 后 运行 测试 。 这 时 你 认为 测试 通过 的 原因 是 编写 了 正确 的 代码 。 
但 是 , 事实 上 测试 通过 的 原因 是 本 轮 运行 并 不 包含 新 的 测试 。 而 你 在 发 现 这 一 问题 前 或 许 还 在 沾 
沾 自 喜 呢 ! 

遵循 TDD 周 期 能 够 让 你 避免 因此 类 错误 而 浪费 许多 时 间 。 



















































































3.5.2 ”测试 了 错误 的 代码 


和 运行 了 错误 的 测试 一 样 ， 你 也 会 测试 了 错误 的 代码 。 通 常 而 言 ， 这 和 编译 错误 有 关 , 但 也 
并 非 总 是 如 此 。 下 面 罗 列 了 测试 错误 代码 的 原因 。 
OQ 忘记 了 保存 或 编译 。 这 种 情况 下 ,“ 错 误 ” 的 代码 是 上 次 编译 的 版 本 ， 并 没有 包含 新 的 改 
动 。 为 了 避免 这 种 错误 ， 你 可 以 让 单元 测试 的 运行 依赖 编译 ， 或 者 将 运行 测试 作为 构建 
后 的 一 个 步骤 。 
OQ 构建 失败 了 ， 但 你 却 没 注意 到 ， 还 沾沾自喜 地 认为 构建 成 功 了 。 
口 构建 脚本 有 缺陷 。 你 是 不 是 链接 到 了 错误 的 对 象 模块 ? 目标 对 象 模 块 是 不 是 和 另外 一 个 
对 象 模块 重 名 了 ? 
a 你 在 测试 错误 的 类 。 如 果 你 在 使 用 测试 替身 做 些 有 趣 的 事情 ， 它 允许 你 使 用 多 态 的 替换 


































































































3.5 表 里 不 一 53 





以 便 测 试 更 加 容易 。 而 运行 的 测试 使 用 的 实现 很 可 能 跟 你 预想 的 不 一 致 。 


3.5.8 不当 的 测试 规范 
你 写 了 个 测试 ， 而 它 断 言 的 东西 却 不 是 你 要 的 。 
试想 我 们 写 了 一 个 测试 ， 如 下 所 示 : 
TEST F(APortfolio, IsEmptyWhenCreated) { 
ASSERT THAT(portfolio.isEmpty(), Eq(false)); 


} 


E, 不 , 从 测试 的 名 称 上 看 ,Portfolio 类 实例 在 创建 时 应 该 为 空 。 所 以 我 们 期 望 的 jsEmpty() 
返回 值 应 该 为 true， 而 不 是 faLse。 


如 果 出 现 提前 通过 的 情况 ， 要 重读 一 下 测试 ， 确 保 它 规定 了 正确 的 行为 。 


























3.5.4 对 系统 的 无 效 假设 


试想 你 写 了 一 个 测试 ， 它 一 运行 就 通过 了 。 你 也 确定 运行 了 正确 的 测试 并 且 所 测 的 代码 也 
是 对 的 。 你 重新 审阅 了 测试 ,确信 它 的 行为 是 你 想 要 的 。 这 么 说 来 ， 系 统 中 已 经 存在 了 测试 所 规 
定 的 功能 。 咽 …… 

之 所 以 写 了 这 个 测试 ， 是 因为 你 假定 这 个 行为 在 系统 中 是 不 存在 的 ( 参见 3.5.8 节 )。 这 个 通 
过 的 测试 告诉 你 之 前 的 假设 是 错误 的 ， 所 测 行为 已 经 在 系统 中 了 。 这 时 ， 你 必须 停 下 来 ， 就 之 前 
你 认为 已 经 添加 的 行为 来 分 析 系统 ， 直 到 了 解 了 足够 的 情况 再 进行 下 一 步 的 操作 。 

在 这 种 情况 下 , 测试 通过 是 好 事 。 重 要 的 事情 已 经 营 示 过 你 了 。 或 许 你 误解 了 第 三 方 组 件 的 
行为 。 花 点 时 间 仔细 考查 一 下 也 许 就 可 以 避免 发 布 一 个 缺陷 。 










































































3.5.5 不 佳 的 测试 顺序 


RetweetCollection 类 接口 需要 size() 和 一 个 便捷 成 员 函 数 isEmpty() 。 我 们 会 在 这 两 个 接口 
的 测试 通过 后 , 重 构 ijsEmpty() 实 现 , 并 将 任务 委派 给 size(), 这样 就 不 需要 为 两 个 相关 的 概念 
提供 不 同 的 算法 。 








c3/2/RetweetCollectionTest.cpp 


#include "gmock/gmock.h" 
#include "RetweetCollection.h" 


using namespace ::testing; 


class ARetweetCollection: public Test ( 
public: 
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RetweetCollection collection; 


h 


TEST F(ARetweetCollection, IsEmptyWhenCreated) ( 
ASSERT TRUE(collection.isEmpty()); 


} 


TEST F(ARetweetCollection, HasSizeZeroWhenCreated) { 
ASSERT THAT(collection.size(), Eq(0u)); 
} 


c3/2/RetweetCollection.h 


#ifndef RetweetCollection h 
define RetweetCollection h 
class RetweetCollection { 


public: 
bool isEmpty() const ( 
return 0 -- size(); 
} 
unsigned int size() const { 
return 0; 
H 
h 
#endif 





为 了 扩展 空 的 概念 ， 我 们 写 了 下 面 的 测试 ， 以 确保 一 旦 将 tweets 加 入 到 retweet 集 合 中 ， 集 合 
就 不 为 空 。 


c3/3/RetweetCollection.h 


#include "Tweet.h" 


TEST F(ARetweetCollection, IsNoLongerEmptyAfterTweetAdded) { 
collection.add(Tweet()); 


ASSERT FALSE(collection.isEmpty()); 
} 


(但 目前 为 止 ， 我 们 不 必 关 心 tweet 的 内 容 ， 只 需 为 Tweet.h 中 的 Tweet 类 定义 提供 class 
Tweet{}; 即 可 。) 


这 里 只 要 引入 一 个 跟踪 集合 大 小 的 变量 ， 就 可 以 让 测试 NoLongerEmptyAfterTweetAdded 通 











c3/3/RetweetCollection.h 


#include "Tweet.h" 


class RetweetCollection { 
public: 

> RetweetCollection() 

» : size (0) { 
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bool isEmpty() const { 





return 0 == size(); 

} 

unsigned int size() const { 
» return size ; 

} 
» void add(const Tweet& tweet) { 
» size = 1; 
» } 
» private: 
» unsigned int size ; 

}; 














但 是 ， 问 题 来 了 。 如 果 我 们 想 知 道 在 加 入 一 个 tweet 后 size() 的 行为 ， 它 会 立刻 通过 测试 。 








c3/A/RetweetCollectionTest.cpp 


TEST F(ARetweetCollection, HasSizeOfOneAfterTweetAdded) ( 
collection.add(Tweet()); 


ASSERT THAT(collection.size(), Eq(1u)); 
} 


我 们 该 怎样 做 才能 避免 这 样 的 事情 发 生 呢 ? 

在 回答 这 个 问题 之 前 ， 我 们 或 许 需 要 换个 不 同 的 视角 看 竺 问题。 需要 写 这 个 测试 吗 ? TDD 
是 为 了 增强 信心 的 ， 而 不 是 穷 举 测试 。 我 们 一 旦 对 一 个 实现 有 了 足够 的 信心 ， 就 可 以 不 用 写 测 
试 。 或 许 应 该 删 掉 测试 HasSizeOfOneAfterTweetAdded， 然 后 继续 。 又 或 者 ， 应 该 保留 它 用 作文 
档 之 用 。 

否则 ， 只 要 遇 到 测试 提前 通过 ,我 们 就 该 看 看 为 之 前 测试 的 通过 所 编写 的 代码 。 是 不 是 写 了 
过 多 的 代码 ?就 当前 情形 而 言 ， 不 是 ， 现 在 的 代码 已 经 简单 得 不 能 再 简单 了 。 但 是 如 果 在 引入 
size() 前 就 扩展 空 的 行为 了 呢 ? 如 果 测 试 顺序 是 : IsEmptyWhenCreated , ISNoLongerEmptyA fter- 
TweetAdded, 、HasSizeZeroWhenCreated， 人 情况 会 稍 有 不 同 。 


















































c3/5/RetweetCollection.h 
class RetweetCollection { 
public: 
RetweetCollection() 
: empty (true) { 
J 


bool isEmpty() const { 
return empty ; 


} 
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void add(const Tweet& tweet) { 
empty - false; 
} 


unsigned int size() const { 
return 0; 


} 


private: 
bool empty ; 
}; 
这 时 ， 我 们 不 能 把 size() 和 isEmpty() 联 系 起 来 ， 因 为 还 没有 测试 规定 size() 的 行为 。 所 
以 ,也 不 能 重 构 size()， 它 依然 可 以 返回 一 个 硬 编码 的 值 。 如 果 现 在 加 入 HasSizeOfOneAfter- 
TweetAdded， 测 试 就 会 失败 。 让 测试 通过 的 最 简单 的 方法 似乎 有 点 古怪 ,但 是 没关系 ! 

















c3/6/RetweetCollection.h 


unsigned int size() const ( 
» return isEmpty() ? 0 : 1; 
} 


程序 员 很 容易 犯 懒 。 你 可 能 不 大 愿意 回 滚 代码 改动 , 从 头 来 过 以 便 找 到 一 个 避免 提前 通过 的 
路 径 。 但 是 , 你 能 在 此 返工 的 过 程 中 学 到 一 些 重要 且 有 价值 的 东西 。 如 果 不 这 么 做 的 话 ， 至 少 你 
也 要 绞 尽 脑汁 去 思考 怎样 才 可 能 避免 提前 通过 ， 这 或 许 会 帮助 你 避免 再 次 出 现 此 类 情况 。 






































3.5. ”相关 联 的 产品 代码 

前 一 节 中 介绍 的 isEmpty() 是 让 客户 代码 更 简洁 的 便捷 方法 。 它 和 大 小 是 联系 在 一 起 的 (我 
们 也 这 样 编写 代码 )。 当 大 小 为 零 时 ， 集 合 为 空 ; 反之 ， 集 合 不 为 空 。 

添加 诸如 isEmpty() 的 便捷 方法 会 导致 重复 接口 的 出 现 。 它 代表 客户 可 以 用 不 同 的 方式 , 与 
已 经 测试 驱动 开发 出 的 行为 交互 。 这 意味 着 isEmpty( ) 的 测试 会 自动 通过 。 但 是 ,我 们 仍然 需要 
说 明 它 的 行为 。 

在 向 RetweetCollection 类 中 添加 新 的 功能 时 ， 例 如 合并 相似 的 tweet， 我 们 需要 验证 新 的 行为 
是 否 能 合理 地 影响 集合 的 大 小 和 空 。 有 几 种 方法 可 以 同时 验证 这 一 点 。 

第 一 种 方法 是 ， 对 于 每 一 个 与 大 小 相关 的 断言 ， 在 判断 是 否 为 空 的 函数 上 加 上 第 二 个 断言 。 
这 种 方法 会 导致 不 必要 的 重复 代码 ， 测 试 也 会 显得 混乱 不 堪 。 







































































c3/7/RetweetCollectionTest.cpp 


TEST F(ARetweetCollection, DecreasesSizeAfterRemovingTweet) ( 
collection.add(Tweet()); 


collection.remove(Tweet()); 


ASSERT THAT(collection.size(), Eq(0u)); 





ASSERT TRUE(collection.isEmpty()); // 不 要 这 么 做 
} 


第 二 种 方法 是 , 对 每 个 针对 大 小 的 测试 , 也 为 空 写 个 测试 ,虽然 这 符合 “一 个 测试 一 个 断言 ”， 
但 仍 会 产生 大 量 的 重复 代码 。 




















c3/8/RetweetCollectionTest.cpp 


TEST F(ARetweetCollection, DecreasesSizeAfterRemovingTweet) { 
collection.add(Tweet()); 
collection.remove(Tweet()); 
ASSERT THAT(collection.size(), Eq(0u)); 

} 

// 避免 这 样 做 

TEST_F(ARetweetCollection, IsEmptyAfterRemovingTweet) { 
collection.add(Tweet()); 
collection.remove(Tweet()); 
ASSERT TRUE(collection.isEmpty()); 

} 


第 三 种 方法 是 编写 一 个 辅助 方法 或 自 定义 断言 。 大 小 和 空 之 间 有 概念 上 的 联系 ,因此 或 许 应 
该 建立 断言 方面 的 概念 联系 。 



































c3/9/RetweetCollectionTest.cpp 


» MATCHER P(HasSize, expected, "") ( 

» return 

» arg.size() -- expected && 

» arg.isEmpty() == (0 == expected); 
»*) 


TEST F(ARetweetCollection, DecreasesSizeAfterRemovingTweet) { 
collection.add(Tweet()); 


collection.remove(Tweet()); 


» ASSERT THAT(collection, HasSize(0u)); 

H 
Google Mock 中 的 MATCHER_P 宏 自 定 义 了 一 个 匹配 器 ， 它 接受 一 个 参数 。 参 见 https:/code. 
google.com/p/googlemock/wiki/CheatSheet 获 取 更 多 的 信息 。 如 果 你 使 用 的 单元 测试 工具 不 支持 自 
定义 匹配 器 的 话 ， 那 么 可 以 使 用 一 个 简单 的 帮助 方法 达到 同样 的 效果 。 


第 四 种 方法 是 为 这 两 个 概念 显 式 地 创建 测试 , 说明 它们 之 间 的 联系 。 从 某 种 意义 上 讲 ， 这 是 
文档 化 的 一 种 方式 。 这 样 ， 在 以 后 的 测试 中 就 不 用 为 测试 空 担 忧 了 。 























c3/10/RetweetCollectionTest.cpp 


TEST F(ARetweetCollection, IsEmptyWhenItsSizeIsZero) ( 
ASSERT THAT(collection.size(), Eq(0u)); 


ASSERT TRUE(collection.isEmpty()); 





58 第 3 章 测试 驱动 开发 基础 





TEST F(ARetweetCollection, IsNotEmptyWhenItsSizeIsNonZero) { 
collection.add(Tweet()); 
ASSERT THAT(collection.size(), Gt(0u)); 


ASSERT FALSE(collection.isEmpty()); 
} 


(在 表达 式 Gt(0) 中 ，Gt 表 示 大 于 )。 

在 这 两 个 测试 中 ， 用 于 断言 大 小 的 是 前 置 条 件 断 言 。 从 技术 上 讲 , 它们 是 不 需要 的 , 但 在 本 
例 中 则 是 为 了 突显 这 两 个 概念 之 间 的 联系 。 

通常 ,我 喜欢 第 四 种 方法 ,虽然 有 时 候 第 三 种 方法 也 很 有 效 。TDD 不 是 精确 的 科学 ,你 可 以 
使 用 不 同 的 方法 , 这 意味 着 你 需要 不 时 地 停 下 来 评估 当前 方案 , 进而 选择 适用 于 当前 上 下 文 的 最 
佳 方案 。 





















































3.5.7 ”过 度 编码 


编写 过 程序 的 人 往往 自 认 为 清楚 最 终 解决 方案 需要 哪些 技术 。“ 我 知道 这 里 需要 使 用 一 个 字 
典 数据 结构 ， 那 么 目前 就 先 在 map 中 编码 吧 。” 或 者 ,“ 是 的 ， 我 们 需要 处 理 代码 中 抛 出 的 异常 ， 
但 我 们 可 以 先 在 catch 块 中 记录 错误 然后 重新 抛 出 。 

优秀 的 程序 员 往 往 有 这 样 的 倾向 和 直觉 , 他 们 知道 代码 需要 做 什么 。 你 不 需要 握 弃 这 些 自 然 
萌发 的 想法 。 我 们 可 以 通过 了 解 基于 哈 希 的 数据 结构 来 找到 更 好 的 解决 方案 , 并 且 知 道 它 会 出 现 
的 错误 类 型 也 是 至 关 重 要 的 。 

如 果 你 想 成 功 运用 TDD， 就 必须 确保 增 量 地 引入 这 些 想 法 ， 并 配 以 相应 的 测试 。 保 持 “ 红 - 
绿 - 重 构 ” 的 节奏 能 提供 许多 安全 保障 ， 同 时 也 有 助 于 单元 测试 数目 和 覆盖 率 的 增长 。 

提前 引入 map 有 时 会 导致 测试 提前 通过 ， 因 为 这 样 做 会 覆盖 代码 中 需要 处 理 的 许多 情形 。 由 
此 带 来 的 后 果 是 ,你 会 忽略 大 量 有 用 的 测试 。 相反 ,你 可 以 慢 慢 地 改进 底层 的 数据 结构 ， 用 一 些 
失败 的 测试 来 证 明 解 决 方案 需要 一 般 化 处 理 。 


有 时 候 你 会 觉得 自己 甚至 不 需要 一 个 map。 与 此 同时 ， 不 做 多 余 需求 的 实现 可 以 保持 代码 简 
单 。 这 样 做 也 可 以 避免 在 存在 更 简单 的 解决 方案 时 ， 引 入 长 时 间 的 过 度 复杂 的 代码 。 

为 异常 处 理 编写 测试 可 以 帮助 客户 端 程序 员 更 好 地 理解 怎样 与 你 的 类 交互 。 这 样 做 也 能 帮助 
你 清楚 地 理解 并 记录 有 可 能 出 问题 的 情形 。 

学 会 仅仅 编写 足够 的 代码 是 TDD 中 更 加 有 挑战 性 的 事情 之 一 ,但 是 你 一 旦 掌握 ,将 受益 无 穷 。 
恪守 “ 红 - 绿 - 重 构 ” 有 助 于 强化 TDD 的 增 量 方法 。 
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3.5.8 确定 性 测试 


有 时 候 你 并 不 知道 代码 在 一 些 特定 情形 下 是 怎样 工作 的 。 你 认为 TDD 的 代码 应 该 是 一 个 完整 
的 解决 方案 ， 但 并 不 确定 。 "我 们 的 算法 处 理 这 一 情形 了 吗 ? ”你 可 以 有 针对 性 地 写 一 个 测试 来 
探测 系统 行为 。 如 果 测 试 失败 ， 你 就 仍 处 于 “ 红 - 绿 - 重 构 ” 周 期 ， 这 个 失败 的 测试 将 会 促使 你 为 
新 的 情形 编写 代码 。 


如 果 测 试 通过 ,好 极 了 ! 系统 在 按照 预期 工作 。 你 可 以 继续 开发 。 但 是 应 该 保留 还 是 丢弃 这 
个 新 测试 呢 ? 答案 取决 于 其 文档 的 作用 有 多 大 。 它 有 助 于 以 后 的 客户 或 开发 者 理解 一 些 重要 的 寻 
Tin? 它 有 助 于 说 明 另 一 个 测试 失败 的 原因 吗 ? 如果 是 的 话 ， 保 留 测试 。 否 则 ， 移 除 该 测试 。 

当 你 写 一 个 测试 探测 系统 行为 时 , 代表 着 你 要 验证 一 个 关于 系统 的 假设 。 也许 你 认为 确定 性 
测试 和 对 系统 的 无 效 假设 (参见 3.5.4 节 ) 类 似 。 其 实 它们 的 不 同 点 是 : 每 当 你 写 一 个 测试 时 ,你 
期 望 它 失败 还 是 通过 。 如 果 你 期 望 测试 失败 , 但 它 却 通 过 了 ,这 属于 对 系统 的 无 效 假设 。 如 果 你 
期 望 这 个 测试 通过 ， 那 么 这 就 是 确定 性 测试 。 
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3.5.9 停 下 来 想 一 下 


测试 提前 通过 的 情况 应 该 很 少见 。 但 是 这 种 情形 却 很 重要 ， 尤 其 是 在 学 习 TDD 时 。 一 旦 出 
现 此 类 情况 ， 可 以 问 自 己 几 个 问题 : 我 漏 掉 了 什么 ? 我 的 步伐 是 不 是 大 了 点 儿 ? 我 有 没有 犯 思 
蠢 的 错误 ?” 如果 不 这 样 做 会 是 什么 结果 呢 ? 和 编译 警告 一 样 ， 你 始终 要 去 揣摩 测试 提前 通过 背 
后 的 真相 。 

































































3.6 成 功 运用 测试 驱动 开发 的 思维 


TDD 是 一 个 原则 , 能 帮助 改善 设计 质量 , 但 不 是 验证 系统 功能 的 普通 方法 。 持 有 正确 的 实践 
心态 是 成 功 运用 TDD 的 基础 。 下 面 是 在 运用 TDD 时 一 些 有 效 的 思维 方式 。 















































3.6.1 增 量 性 


TDD 以 渐进 的 方法 从 无 到 有 地 开发 一 个 功能 完善 的 系统 。 每 当 往 系统 中 加 入 一 个 新 的 行为 单 
元 时 , 你 清楚 地 知道 系统 仍 会 正常 工作 ,因为 你 为 该 新 行为 编写 了 一 个 测试 , 并 且 以 往 加 入 的 行 
为 也 有 对 应 的 测试 。 你 只 有 在 新 功能 与 其 他 所 有 功能 协同 工作 时 才能 继续 前 进 。 同 样 ， 你 也 清楚 
地 了 解 系统 的 设计 目的 ， 因 为 单元 测试 描述 了 加 入 系统 中 的 行为 。 


TDD 的 增 量 方法 和 敏捷 流程 相 契 合 〈 虽然 你 可 以 在 任何 流程 中 使 用 TDD )。 敏 捷 开 发 定义 了 
短 的 迭代 周期 〈 通 常 一 周 或 两 周 )， 在 此 期 间 你 定义 、 构 建 并 发 布 少量 功能 。 每 次 迭代 都 代表 了 
需求 级 别 最 高 的 功能 特性 。 在 随后 的 每 次 迭代 中 都 可 以 完全 改变 优先 顺序 。 敏捷 开发 者 甚至 可 以 
提前 取消 项 目 。 这 没关系 ,因为 敏捷 就 是 为 最 高 业务 需求 而 生 的 。 将 其 结果 与 传统 开发 方法 ( 先 
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花费 数 月 时 间 做 需求 分 析 ， 然 后 设计 ， 再 编码 ) 对 比 会 发 现 , 后 者 在 完成 分 析 和 设计 前 ,没有 什 
么 有 实际 意义 的 产 出 ， 而 且 通 常 这 样 的 状态 会 延续 到 所 有 编码 都 完成 。 

TDD 文 持 类 似 于 增 量 思维 的 小 步 方 法 。 你 可 以 逐个 地 处 理 单元 ,使 用 测试 来 定义 和 验证 它们 。 
在 任何 时 间 点 上 , 你 都 可 以 停止 开发 ,并且 知 道 你 已 构建 了 测试 所 描述 的 所 有 系统 行为 。 任 何 没 
有 测试 描述 的 行为 都 没 实现 ， 而 经 测试 描述 的 行为 则 正确 且 完 整地 实现 了 。 







































































3.6.2 ”测试 行为 而 非 方法 


TDD 初 学 者 常会 犯 的 一 个 错误 是 集中 精力 去 测试 成 员 函 数 。“ 我 们 实现 了 一 个 add() 成 员 函 
数 。 再 写 一 个 TEST(ARetweetCollection，Add) 的 测试 ”但 是 ， 写 一 个 完全 和 履 盖 add 行 为 的 测 
试 需要 考虑 多 种 不 同 的 情形 。 结果 是 你 必须 将 许多 不 同 的 行为 编码 进 同 一 个 测试 。 此 时 , 测试 就 
没有 文档 价值 了 ， 同时， 理解 一 个 测试 花费 的 时 间 也 会 增加 。 

相反 , 你 要 把 注意 力 放 在 行为 或 描述 行为 的 情形 上 。 如 果 加 入 一 个 之 前 已 经 加 入 的 tweet 会 发 
生 什 么 ? 如 果 客 户 传人 一 个 空 的 fweet 呢 ? 如 果 用 户 不 再 是 一 个 有 效 的 Twitter 用 户 呢 ? 

我 们 就 这 些 关 于 加 入 tweets 的 考量 做 下 面 几 个 独立 的 测试 。 


TEST(ARetweetCollection, IgnoresDuplicateTweetAdded) 
TEST(ARetweetCollection, UsesOriginallweetTextWhenEmptyTweetAdded) 
TEST(ARetweetCollection, ThrowsExceptionWhenUserNotValidForAddedTweet ) 


这 样 ， 你 就 能 全 面 地 查看 测试 名 称 ， 并 且 了 解 系统 支持 的 确定 行为 。 










































































3.6.3 ”使 用 测试 来 描述 行为 

你 可 以 把 测试 想 成 一 个 示例 , 用 它 来 描述 或 文档 化 系统 中 的 行为 。 你 可 以 通过 以 下 两 个 方面 
来 充分 理解 一 个 编写 良好 的 测试 : 第 一 , 测试 名 称 , 它 概括 了 在 特定 上 下 文中 系统 表现 出 的 行为 ; 
第 二 ， 测 试 语句 本 身 ， 它 精炼 地 展现 了 一 个 测试 的 行为 。 


























c3/11/RetweetCollectionTest.cpp 


TEST F(ARetweetCollection, IgnoresDuplicateTweetAdded) { 
Tweet tweet("msg", "Quser"); 
Tweet duplicate(tweet); 
collection.add(tweet); 


collection.add(duplicate); 


ASSERT THAT(collection.size(), Eq(1u)); 
} 


测试 名 称 提供 了 高 层次 的 概括 : 应 该 忽略 重复 添加 的 tweet。 但 什么 才 算 重 复 的 tweet? 忽略 
重复 的 tweet 意 味 着 什么 ”这 个 测试 提示 了 一 个 简单 的 示例 ， 清 楚 地 回答 了 这 两 个 问题 。 当 一 个 
tweet 和 男 一 个 tweet 完 全 相同 时 ， 算 作 重复 ;， 当 加 入 一 个 重复 的 tweet 后 ，tweet 和 集合 的 大 小 不 变 。 
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越 是 重视 TDD 的 文档 功能 , 越 懂 得 高 质量 测试 的 重要 性 。 测 试 的 文档 功能 是 TDD 的 附属 产物 。 
为 了 确保 在 单元 测试 中 的 投入 得 到 良好 的 回报 , 必须 保证 其 他 人 能 够 很 容易 地 理解 测试 , 否则 你 
的 测试 就 是 在 浪费 他 们 的 时 间 。 


良好 的 测试 可 以 通过 全 面 地 记录 系统 行为 来 节省 时 间 。 只 要 所 有 的 测试 都 通过 , 它们 就 准确 
地 传达 了 系统 的 内 部 行为 。 文 档 也 不 会 过 时 。 





























3.6.4 保持 简单 


无 谓 的 复杂 性 带 来 的 成 本 是 无 止境 的 。 相信 你 曾 花 费 无 数 个 小 时 去 解读 一 个 复杂 的 成 员 函 数 
或 错综复杂 的 设计 。 大 多 数 时 候 , 你 都 可 以 编写 一 个 更 简单 的 解决 方案 , 从 而 节省 每 个 人 的 时 间 。 


有 很 多 原因 会 导致 开发 人 员 制 造 出 无 请 的 复杂 性 。 


O 时 间 压 力 。“ 我 们 只 需要 发 布 代码 ， 然 后 继续 开发 。 我 们 没有 时 间 把 事情 做 得 更 好 。” 没 
有 时 间 是 迟早 的 事 ， 因 为 你 将 耗费 十 信 的 时 间 做 任何 事情 。 轻 率 使 复杂 性 不 断 积累 ， 这 
将 在 多 个 方面 (代码 可 理解 性 、 修 改 代码 的 开销 、 构 建 时 间 ) 让 你 速度 变 慢 。 

D 缺乏 学 习 。 在 追求 更 好 的 代码 的 同时 ， 也 要 勇于 承认 制造 出 来 的 不 良 代码 。 这 意味 着 你 
必须 理解 两 者 的 差别 。 你 可 以 通过 团队 成 员 结对 和 审阅 的 方式 获得 真实 的 反馈 。 学 习 怎 

样 识别 设计 缺陷 和 代码 坏 味 。 学 习 怎 样 以 更 好 的 方式 去 纠正 它们 ， 可 以 找 几 本 关于 创建 
简洁 设计 和 代码 的 书 来 学 习 。 

O 已 有 的 复杂 性 。 一 个 设计 繁杂 的 已 有 代码 库 会 让 你 在 添加 新 行为 时 束 手 束 脚 。 过 长 的 广 

法 会 催生 更 宛 长 的 方法 ， 高 耦合 的 设计 也 是 孕 刘 更 高 而 合 设计 的 温床 。 

D 害怕 改 代码 。 如 果 未 经 测试 的 话 ， 你 不 会 一 直 写 出 正确 的 代码 。“ 如 果 没 有 出 现 问题 ， 就 
不 要 去 修复 .” 害 怕 修 改 代码 会 阻碍 向 更 好 的 、 可 持续 的 设计 进行 重 构 。 使 用 TDD 的 话 ， 
每 个 通过 的 测试 都 会 提供 改善 代码 的 机 会 ( 或 者 至 少 不 会 让 代码 退化 )。 第 6 章 将 会 专 站 
讨论 如 何 编写 正确 的 代码 。 

D 及 测 。“ 客 户 和 账号 之 间 可 能 存在 多 对 多 的 关系 ， 所 以 现在 就 把 这 个 添加 到 系统 中 。” 或 
许 大 多 数 时 候 你 是 对 的 ， 但 是 你 要 承受 过 早 引 入 的 复杂 性 。 有 时 候 ， 你 会 选择 另外 一 条 
思路 ,这 时 ， 你 将 不 断 地 为 这 个 (无 用 的 ) 额外 的 复杂 性 买单 ， 或 者 至 少 也 要 花费 大 量 
精力 移 除 这 个 没 必要 的 复杂 性 。 相 反 ， 你 应 该 在 真正 需要 的 时 候 再 考虑 上 述 做 法 。 通 常 ， 
这 样 做 不 会 带 来 额外 的 开销 。 

保持 简单 是 你 在 持续 变化 的 环境 中 的 生存 之 道 。 在 敏捷 开发 里 ， 每 次 办 代 都 会 交付 新 特性 ， 

其 中 一 些 你 可 能 从 未 考虑 过 。 这 是 个 挑战 ;如 果 系统 不 能 适应 新 的 改动 ， 你 就 需要 把 新 功能 强加 

进 系统 。 为 此 ,最 好 的 防范 办 法 就 是 保持 简单 的 设计 : 代码 易 读 、 没 有 宛 余 、 没 有 无 谓 的 复杂 性 。 

具有 这 些 特征 的 系统 会 最 大 程度 地 降低 维护 成 本 。 
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3.6.5 ”恪守 测试 驱动 开发 周期 


如 果 你 未 能 遵循 “ 红 - 绿 - 重 构 ”周期 ， 将 会 为 此 付出 代价 。 参 见 3.5 节 来 了 解 为 什么 第 一 时 
间 注 意 到 测试 失败 很 重要 。 很 明显 ,如果 你 期 望 通过 的 测试 失败 了 , 这 意味 着 添加 的 代码 不 能 
常 工 作 。 更 重要 的 是 ， 如果 不 经 历 重 构 阶 段 的 话 , 你 的 设计 质量 会 降低 。 不 能 恪守 TDD 规 范 流程 
会 让 你 的 开发 速度 变 慢 。 






































3.7 成 功 运用 测试 驱动 开发 的 方法 


前 一 节 中 重点 讲述 了 成 功 运用 TDD 的 哲学 。 这 一 节 中 将 讨论 各 种 具体 技巧 , 这 些 技巧 将 帮助 
你 在 TDD 的 道路 上 顺利 前 行 。 








3.7.1 下 一 个 测试 是 什么 


既然 已 经 开始 学 习 TDD， 那 么 蒙 绕 在 你 心头 上 的 最 大 问题 之 一 就 是 : 下 一 个 测试 应 该 怎么 
写 ? 本 书 中 的 示例 就 这 个 问题 给 出 了 一 些 答案 。 

其 中 一 个 答案 是 : 如 果 一 个 测试 需要 的 产品 代码 最 少 , 那么 就 写 这 个 测试 。 但 这 到 底 是 什么 
意思 呢 ? 

Bob 大 叔 设 计 了 一 个 体系 ， 用 于 将 每 步 变换 分 类 ( 参考 10.4 节 )。 所 有 的 变换 按 从 最 简单 (最 
高 优先 级 ) 到 最 复杂 (最低 优先 级 ) 安排 优先 级 顺序 。 你 要 做 的 就 是 选择 一 个 最 高 优先 级 的 变换 ， 
然后 为 此 变换 写 一 个 测试 。 按 照 变换 优先 级 增 量 地 进行 ， 就 能 得 到 一 个 理想 的 测试 顺序 。 上 述 内 
容 就 是 前 提 : 变换 优先 级 假设 (Transformation Priority Premise, TPP )。 

如 果 你 觉得 TPP 听 起 来 很 复杂 ， 那 是 因为 它 本 身 就 复杂 。 它 是 一 个 理论 。 目 前 而 言 ， 它 证 明 
了 许多 面向 算法 的 解决 方案 是 有 意义 的 。 
除 此 之 外 ， 你 还 可 以 通过 回答 下 面 的 问题 作出 决定 。 
口 从 逻辑 上 来 说 ， 哪 个 行为 最 具 意 义 ? 
口 你 可 以 验证 这 个 有 意义 的 行为 中 的 哪个 最 小 集合 ? 
a 你 能 写 一 个 测试 来 说 明 当 前 的 行为 不 完备 吗 ? 

让 我 们 测试 驱动 开发 一 个 名 为 SQL 的 类 , 这 个 类 的 工作 就 是 根据 数据 库 表 的 元 数据 生成 一 些 
SQL 语句 ( select、insert、delete， 等 等 )。 

我 们 可 以 通过 每 个 新 的 测试 获得 有 意义 的 行为 。 也 就 是 说 我 们 不 会 直接 测试 驱动 开发 getter、 
setter 或 构造 函数 ,。( 在 开发 有 用 行为 时 会 按 需 地 编写 它们 。) 生成 操作 数据 表 的 SQL 语句 的 操作 似 
平 有 用 有 旦 足够 小 。 我 们 先 从 drop table 或 truncate table 开 始 写 起 。 
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测试 名 称 


GenerateDropUsingTableName 





实现 


return. "drop" -tableName - 


























这 很 简单 ， 只 需要 几 分 钟 就 能 编 好 。 我 们 能 很 快 地 编写 好 truncate。 
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目前 , ESOL i] HT 








L 








数据 表 名 称 追 加 到 一 个 命令 字符 串 后 , 这 提示 我 们 可 以 重 构 ， 











以 简化 drop 和 truncate 语 句 的 创建 。( 示例 中 ， 变 量 Drop 和 Truncate 是 常量 字符 串 ， 每 个 尾部 


都 有 一 个 空格 。) 


std::string dropStatement() const ( 


return createCommand (Drop) ; 


} 


std::string truncateStatement() const { 
return createCommand (Truncate); 


} 


std::string createCommand (const std::string& name) const { 


return name + tableName ; 


H 




















我 们 也 注意 到 了 目前 我 们 做 得 还 不 够 。 如 果 客 户 代码 传人 的 数据 表 名 称 为 空 的 话 , 代码 处 理 


起 来 就 会 出 问题 。 








有 时 在 处 理 所 有 的 常规 路 径 前 , 提前 考虑 异常 情况 是 十 分 必要 的 。 有 时 候 , 你 也 可 以 稍 晚 一 
些 再 来 处 理 这 些 情 况 。 通 常情 况 下 ,你 在 很 短 的 时 间 内 就 可 以 编写 出 针对 异常 情况 的 测试 , 仅仅 
需要 少量 的 非 侵 入 式 的 代码 改动 ， 就 可 通过 这 个 测试 。 





测试 名 称 























ConstructionThrowsWhenTableNameEmpty 





实现 


if (tableName .empty()) throw ... 





我 们 选择 select 语 句 作为 下 一 步 有 意义 的 增 量 代码 。 最 简单 的 情形 就 是 文 持 seLect#。 


测试 名 称 


GenerateSelectStar 





实现 


return createCommand(SelectStarFrom) 





支持 列 查 询 很 重要 ， 因 为 大 多 数 开发 者 认为 相 比 于 select*， 列 查询 是 更 好 的 实践 。 





测试 名 称 


GenerateSelectWithColumnList 





实现 





return Select + columnList() + From + tableName - 


现在 遇 到 了 稍微 复杂 的 情况 。 可 能 得 花 上 几 分 钟 来 实现 coLumnList () ， 但 仍然 不 需要 大 动 











干戈 ， 测 试 就 能 通过 。 

















这 里 的 select 语 句 并 不 完备 。 我 们 进一步 扩展 使 其 支持 where 条 件 语句 。 





64 PIF 测试 驱动 开发 基础 





测试 名 称 GeneratesSelectWhereColumnEqual 





实现 return selectStatement() + whereEq(columnName, value) 














或 许可 以 把 GeneratesSelectWithColumnList 的 实现 放 到 一 个 名 为 std::string selectSta 
tement() const 的 成 员 函 数 里 。 接 下 来 的 测试 GeneratesSelectWhereColumnEqual 可 以 很 容易 地 
复 用 seLectStatement () 。 这 也 是 我 们 想 要 的 结果 : 每 一 个 测试 都 依赖 于 之 前 的 基础 构建 ， 这 
样 产生 的 影响 最 小 。 

入 而 久之 ,对 于 通过 一 个 给 定 的 测试 ,你 的 思路 就 会 变 得 明明 起 来 。 你 的 工作 就 是 让 自己 的 
生活 轻松 一 些 ， 所 以 最 好 选择 实现 起 来 需要 最 少 的 增 量 代码 的 测试 。 


偶尔 ,你 在 选择 下 一 个 测试 时 也 会 作出 不 理想 的 选择 。 参 见 3.5.5 节 的 示例 。 乐 于 回 深 并 丢弃 
掉 少 量 的 代码 ， 能 帮助 你 更 好 地 学 习 到 怎样 在 实现 的 过 程 中 探寻 更 多 的 增 量 路 径 。 


















































3.7.2 ”十 分 钟 限制 


TDD 依 赖 较 短 的 反馈 周期 。 你 只 要 恪守 “ 红 - 绿 - 重 构 ” 周 期 ， 就 能 在 TDD 中 做 得 很 好 ， 但 
依然 有 可 能 陷入 困境 。 偶 尔 ， 你 会 很 难 让 一 个 测试 通过 ,或 者 在 尝试 清理 代码 时 破坏 一 些 测试 ， 
又 或 者 需要 借用 调试 器 来 探 明 到 底 发 生 了 什么 。 

种 扎 在 所 难免 ， 但 是 可 以 限定 遭受 痛苦 的 时 间 。 从 上 一 个 测试 通过 算 起 ， 不 要 超过 十 分 钟 。 
有 一 些 开 发 者 甚至 用 上 了 定时 器 。 当 然 ,， 不 需要 对 时 间 限 定 得 如 此 精确 , 但 是 当 你 尝试 的 解决 方 
案 有 失 偏 颇 时 ， 做 到 这 一 点 很 重要 。 

如 果 限 定 的 时 间 到 了 ， 那 么 丢掉 你 之 前 的 结果 然后 重新 来 过 。 好 的 版 本 控制 工具 ( 如 Git) 
让 回 滚 变 得 容易 、 迅 速 、 有 效 ， 而 且 很 安全 。( 如 果 你 不 使 用 Git， 那 么 可 以 考虑 在 本 地 使 用 一 个 
桥接 工具 ， 如 git-svn。 ) 

不 要 过 分 纠结 代码 ,特别 是 和 现在 做 的 不 相干 的 代码 。 大 可 忽视 它们 。 不 要 写 超 过 十 分 钟 的 
代码 ， 否则 ,你 的 方案 很 可 能 质量 不 高 。 休 息 一 下 ， 放 空 思绪 ,然后 重新 以 一 个 全 新 的 视角 来 看 
问题 。 

如 果 你 被 之 前 无 法 工作 的 东西 阻碍 了 , 那么 这 一 次 可 以 采取 更 小 的 步伐 来 看 看 到 底 是 哪里 出 
了 问题 。 你 也 可 以 加 入 额外 的 断言 来 验证 有 待 商 榨 的 预想 。 这样 至 少 可 以 找 出 导致 问题 的 那 行 代 
人 码 ， 也 有 可 能 构建 出 更 好 的 解决 方案 。 














































































































3.7.3 ”代码 缺陷 


代码 总 会 有 缺陷 的 。 这 无 法 避免 。 但 是 ,TDD 有 可 能 让 你 的 新 代码 接近 零 缺 陷 。 我 兽 经 见 过 
一 个 团队 , 在 产品 发 布 的 前 十 一 个 月 里 , 其 缺陷 报告 中 只 有 十 五 个 代码 缺陷 。 其 他 使 用 TDD 取 得 
成 功 的 案例 比比 丝 是 。 
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使 用 TDD 几 乎 不 会 出 现 一 些 思春 的 逻辑 错误 。 那 还 会 有 哪些 呢 ? 其 他 的 事情 也 会 出 现 问题 : 
没 人 预料 到 的 条 件 、 不 同步 的 外 部 事情 〈 例 如 ， 配 置 文件 )， 以 及 多 个 方法 或 类 合 在 一 起 时 表现 
出 的 奇怪 行为 。 如 果 规 范 有 问题 也 会 出 错 ， 包 括 因 粗心 而 忽略 掉 一 些 东 西 ， 你 和 客户 间 的 误解 。 


TDD 不 是 银 弹 ， 却 有 助 于 消除 一 些 人 人 都 会 犯 的 逻辑 错误 。( 更 重要 的 是 ， 它 是 精细 打磨 系 
统 设 计 的 绝妙 方法 。) 

当 QA 或 客户 支持 团队 当面 给 你 指出 一 个 代码 缺陷 时 ， 你 该 怎么 做 ? R, 测试 驱动 ! 你 或 许 
可 以 先 写 一 些 简单 的 测试 来 探测 系统 行为 。 专注 于 相关 代码 的 测试 能 帮助 你 更 好 地 理解 代码 是 怎 
样 工作 的 , 也 有 助 于 解读 代码 缺陷 。 有些 时 候 , 你 可 以 保留 这 些 测试 , 并 把 它们 用 作 特 征 测试 "( 参 
见 第 8 章 )。 有 时 候 则 可 以 丢弃 这 些 类 似 一 次 性 工具 的 测试 。 

一 旦 查 明 问题 根源 ， 也 不 要 简单 修复 ,继续 做 其 他 事情 吧 。 我 们 是 在 测试 驱动 开发 ! 相反 ， 
写 一 个 你 认为 能 模拟 暴露 缺陷 的 行为 的 测试 。 确 保 测试 失败 ( 红 ), 修复 它 ( 绿 ), EW. 




































































3.7.4 禁用 测试 

正常 情况 下 , 在 测试 驱动 开发 时 一 次 只 关注 一 件 事 情 。 个 别 情况 下 ， 当 你 忙于 证 第 一 个 测试 
通过 时 ， 第 二 个 测试 失败 了 。 如 果 另 一 个 测试 失败 ， 这 意味 着 你 的 第 一 个 测试 没 能 遵守 “ 红 - 绿 - 
重 构 ” 周 期 〈 除非 这 两 个 测试 是 因为 同一 个 原因 而 失败 )。 

为 了 不 让 第 二 个 失败 的 测试 分 散 你 的 注意 力 ,可 以 让 它 暂 时 失效 。 注 释 掉 测试 代码 是 可 以 的 ， 
但 更 好 的 方法 是 把 测试 标记 为 禁用 。 许 多 工具 有 显 式 地 禁用 测试 的 功能 , 并 且 在 运行 所 有 测试 时 
提示 你 哪些 是 被 禁用 的 。 这 个 提醒 功能 可 以 避免 误 将 测试 禁用 提交 。 

在 Google Mock 中 ， 你 可 以 给 测试 名 称 加 上 DISABLED 前缀 来 禁用 测试 。 

TEST(ATweet, DISABLED RequiresUserNameToStartWithAnAtSign) 

当 运 行 测试 集 时 ，Google Mock 会 在 未 尾 打印 出 提示 ， 这 样 就 可 以 知道 哪些 测试 被 禁用 了 。 


[---------- ] Global test environment tear-down 
[==========] 17 tests from 3 test cases ran. (2 ms total) 
[ PASSED ] 17 tests. 




































































YOU HAVE 1 DISABLED TEST 


不 要 提交 被 禁用 ( 或 注释 掉 ) 的 测试 的 代码 ， 除非 你 有 充足 的 理由 。 集 成 后 的 代码 应 该 反映 
系统 的 当前 功能 。 注 释 掉 的 测试 (或 产品 代码 ) 会 浪费 其 他 开发 者 的 时 间 。 "测试 被 注释 掉 是 因 
为 没有 这 个 行为 了 吗 ? 这 个 测试 有 问题 ? 处 于 变动 中 ? 这 个 测试 运行 太 慢 以 至 于 需要 的 时 候 才 
启用 它 ? 我 是 不 是 应 该 找 个 人 讨论 一 下 这 个 测试 ?” 


















































QD 特征 测试 是 用 来 刻画 遗留 软件 系统 中 特定 行为 的 测试 。 更 多 细节 请 参考 https://en.wikipedia.org/wiki/Characteriza- 


tion test; 译 者 注 
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3.8 RA 


在 本 章 中 我 们 学 习 了 TDD 的 重要 基础 知识 ， 包 括 它 和 单元 测试 的 不 同 点 ， 怎 样 遵 循 TDD 周 
期 (以 及 当 事 情 超出 预期 时 应 该 怎么 应 对 ), 成 功 运用 TDD 的 思维 和 方法 。 本 章 讲 到 的 TDD 背 后 
的 理念 及 哲学 为 继续 学 习 TDD 打 下 了 基础 。 在 下 一 章 中 我 们 将 学 习 怎 样 运用 这 些 理念 来 实现 实 
际 的 测试 。 


























第 4 章 
测试 结构 








4.4 FHA 


到 目前 为 止 , 你 应 该 对 TDD 的 流程 和 概念 有 了 深刻 的 理解 。 本 章 将 深入 讨论 实现 测试 的 具体 
细节 ， 包 括 : 文件 组 织 、fixture 、setup 、teardown 、 过 滤器 、 断 言 和 基于 异常 的 断言 ， 以 及 其 他 
一 些 零 散 的 知识 。 








4.2 组 织 方式 


从 文件 和 逻辑 方面 着 眼 , 应 该 怎样 组 织 测试 呢 ? 在 本 节 中 , 你 将 学 到 怎样 用 fixture 组 织 测 试 ， 
以 及 怎样 利用 setup 和 teardown 这 样 的 钧 子 函 数 。 你 也 会 学 到 如 何 使 用 Given-When-Then ( X ff 
Arrange-Act-Assert ) 的 概念 来 组 织 测 试 内 部 。 


4.2.1 文件 组 织 


在 测试 驱动 开发 相关 行为 时 ,我们 会 将 相关 的 测试 定义 在 同一 个 测试 文件 中 。 例如 ,为 了 测 
iX J"K zl] Jf Jk — ^^ RetweetCollection 类 ( 在 RetweetCollection.cpp/.h 中 实现 )， 从 
RetweetCollectionTest.cpp 开 始 。 不 要 立刻 给 测试 创建 一 个 头 文件 ， 这 是 吃力 不 讨好 的 。 

最 终 你 可 能 需要 多 个 测试 文件 来 验证 相关 的 行为 ， 也 可 能 需要 用 一 个 测试 文件 宪 盖 多 个 地 
方 的 行为 。 不 要 拘泥 于 一 个 类 一 个 测试 文件 这 样 的 形式 。4.2.3 节 将 讲述 一 个 类 有 多 个 测试 文件 
的 原因 。 

基于 所 包含 的 测试 来 给 文件 命名 。 概括 相关 的 行为 , 并 据 此 给 测试 命名 。 选 定 一 个 命名 体系 ， 
诸如 BehaviorDescriptionTest.cpp 、BehaviorDescriptionTests.cpp 或 者 TestBehavriorDescription.cpp。 
只 要 你 的 代码 一 致 地 遵守 此 标准 即 可 。 一 致 的 命名 约定 可 以 让 开发 人 员 更 容易 地 找到 需要 的 
测试 。 
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4.2.2 fixture 


大 多 数 单元 测试 工具 都 支持 将 逻辑 上 相关 的 测试 分 组 。 在 Google Mock 中 , 你 可 以 使 用 Google 
所 谓 的 测试 用 例 名 称 来 将 相关 测试 分 组 。 下 面 的 测试 所 属 的 测试 用 例 名 为 ARetweetCollection。 
IncrementsSizeWhenTweetAdded 是 此 测试 用 例 中 的 一 个 测试 。 

TEST(ARetweetCollection, IncrementsSizeWhenTweetAdded) 

相关 的 测试 运行 时 需要 相同 的 环境 。 你 会 发 现 许多 测试 都 需要 公共 的 初始 化 或 辅助 函数 。 许 
多 测试 工具 能 够 让 你 定义 一 个 fixture 一 一 一 个 跨 测 试 可 重用 的 类 。 

在 Google Mock 中 ， 你 可 以 定义 一 个 派生 自 ::testing::Test 的 fixture。 通 常 是 在 测试 文件 的 开始 
^E. X fixture o 





ni 





using namespace ::testing; 


class ARetweetCollection: public Test { 
H 


下 面 的 两 个 测试 有 些 重 复 代 码 ， 它 们 都 创建 了 RetweetCollection 的 一 个 实例 。 


TEST(ARetweetCollection, IsEmptyWhenCreated) { 
> RetweetCollection collection; 





ASSERT THAT(collection.isEmpty(), Eq(true)); 
} 


TEST(ARetweetCollection, IsNoLongerEmptyAfterTweetAdded) { 
> RetweetCollection collection; 
collection.add(Tweet()); 


ASSERT THAT(collection.isEmpty(), Eq(false)); 
} 


你 可 以 在 fixture 里 定义 一 次 RetweetCollection ， 进 而 去 掉 RetweetCollection 的 局 部 定义 。 


class ARetweetCollection: public Test { 
public: 
» RetweetCollection collection; 
}; 
如 果 想 让 测试 能 人 够 访问 fixture 类 的 成 员 变 量 ， 那 么 就 需要 将 TEST 宏 替换 为 TEST_F (尾部 的 F 
代表 fixture )。 下 面 是 整理 过 的 测试 : 
TEST F(ARetweetCollection, IsEmptyWhenCreated) ( 
ASSERT THAT(collection.isEmpty(), Eq(true)); 








} 


TEST_F(ARetweetCollection, IsNoLongerEmptyAfterTweetAdded) { 
collection.add(Tweet()); 





ASSERT THAT(collection.isEmpty(), Eq(false)); 
} 


42 ”组 织 方式 69 





测试 用 例 的 名 称 必须 与 fixture 的 名 称 一 样 ! 如 果 没 有 使 用 带 _F 的 宏 ， 编译 就 会 出 错 ， 指 明 测 
试 引 用 了 定义 在 fixture 中 的 成 员 变量 ( 这 个 例子 中 就 是 变量 collection )。 

阅读 测试 的 人 通常 不 需要 知道 创建 collection 变 量 这 个 细节 就 能 理解 测试 , 在 这 个 例子 中 ， 
将 其 移 进 fixutre 可 以 避免 分 散 注 意 力 。 如 果 你 也 这 样 将 一 些 代码 从 测试 中 移入 fixture， 那 么 建议 
重新 审阅 一 下 测试 。 如 果 其 意图 依然 清晰 ， 那 很 好 。 如 果 不 是 ， 回 深 你 的 改动 ,或 者 修改 变量 
称 让 其 意义 变 得 明确 。 


你 可 以 而 且 应 该 将 相同 的 函数 移 至 fixture， 特 别 是 在 没有 将 测试 纳入 到 一 个 命名 空间 的 情况 下 。 
































4.2.3 Setup 与 Teardown 


如 果 测试 用 例 中 的 所 有 测试 需要 一 条 或 更 多 的 相同 初始 化 语句 ， 那 么 可 以 将 它们 写 在 fixture EE 
类 的 初始 化 函数 中 。 在 Google Mock 中 ， 必 须 将 此 函数 命名 为 SetUp ( 它 覆 写 了 基 类 ::testing::Test 
中 的 虚 函 数 )。 
对 于 属于 同一 个 fixture 的 测试 ，Google Mock 都 会 创建 一 个 新 的 、 独 立 的 fixture 类 实例 。 这 种 
隔离 有 助 于 减少 测试 在 执行 过 程 中 相互 干扰 而 导致 的 问题 。 这 也 暗示 着 每 个 测试 必须 从 头 创 建 自 
己 的 上 下 文 ， 并 且 这 些 上 下 文 在 测试 之 间 相 互 独立 。 创 建 完 fixture 类 实例 后 ，Google Mock 会 执 
行 SetUp() 中 的 代码 ， 然 后 执行 测试 。 


下 面 两 个 测试 向 集合 中 加 入 一 个 Tweet 对 象 用 以 创建 一 个 初始 上 下 文 : 





























c3/14/RetweetCollectionTest.cpp 

TEST F(ARetweetCollection, IsNoLongerEmptyAfterTweetAdded) ( 
collection.add(Tweet()); 
ASSERT FALSE(collection.isEmpty()); 

} 


TEST F(ARetweetCollection, HasSizeOfOneAfterTweetAdded) { 
collection.add(Tweet()); 
ASSERT THAT(collection.size(), Eq(1u)); 

} 


我 们 为 RetweetCollection 测 试 定 义 一 个 新 的 fixture 来 代表 有 一 个 tweet 的 集合 。 我 们 使 用 
ARetweetCollectionWithOneTweet 作 为 fixture 的 名 称 。 





c3/15/RetweetCollectionTest.cpp 


class ARetweetCollectionWithOneTweet: public Test ( 
public: 
RetweetCollection collection; 
void SetUp() override ( 
collection.add(Tweet()); 
} 
}; 
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用 公共 的 初始 化 代码 创建 出 的 代码 非常 易 读 。 


c3/15/RetweetCollectionTest.cpp 


TEST F(ARetweetCollectionWithOneTweet, IsNoLongerEmpty) 1 
ASSERT FALSE(collection.isEmpty()); 
} 


TEST F(ARetweetCollectionWithOneTweet, HasSizeOfOne) { 
ASSERT THAT(collection.size(), Eq(1u)); 

F 

注意 ， 在 移 除 重复 代码 时 不 要 移 除 一 些 对 理解 测试 至 关 重 要 的 信息 。fixture 的 名 称 清晰 地 描 
述 出 上 下 文 了 吗 ? ARetweetCollectionWithOneTweet 的 意思 似乎 不 言 自 明 ， 但 话说 回来 ， 自 己 说 
服 自己 是 比较 容易 的 。 你 可 以 问 问 其 他 程序 员 。 如 果 非 得 阅读 fixture 的 初始 化 代码 才能 理解 它 的 
意图 ， 那 么 最 好 找 个 方法 让 测试 更 加 明了 。 

第 一 个 测试 最 初 的 名 称 是 用 例 名 和 测试 名 的 组 合 : ARetweetCollection.ISNotLongerEmpty- 
AfterTweetAdded( Google Mock 称 此 组 合 为 测试 的 全 名 ) 现在 , 测试 的 全 名 为 ARetweetCollection- 


WithOneTweet.IsSNoLongerEmpty。 命 名 fixture 让 其 能 描述 上 下 文 后 ， 我 们 就 不 必 将 匈 余 的 描述 信 
息 放 到 每 个 测试 名 称 中 。 


现在 还 有 为 外 一 个 可 以 整理 的 测试 。 




















c3/15/RetweetCollectionTest.cpp 


TEST F(ARetweetCollection, IgnoresDuplicateTweetAdded) { 
Tweet tweet("msg", "Quser"); 
Tweet duplicate(tweet); 
collection.add(tweet); 
collection.add(duplicate); 


ASSERT THAT(collection.size(), Eq(1u)); 
F 
第 一 个 加 入 到 测试 里 的 Tweet 对 象 和 其 他 测试 里 的 Tweet 对 象 不 同 。 它 为 Tweet 的 构造 函数 的 
两 个 参数 都 赋值 了 ， 而 其 他 的 Tweet 对 象 是 以 默认 参数 构造 的 。 但 是 我 们 并 不 真正 关心 测试 中 集 
合 里 的 Tweet 对 象 是 什么 ,只 要 集合 中 包含 一 个 Tweet 就 可 以 了 。 我 们 为 所 有 的 测试 选择 更 有 趣 的 


Tweets 


























c3/16/RetweetCollectionTest.cpp 


class ARetweetCollectionWithOneTweet: public Test ( 
public: 
RetweetCollection collection; 
void SetUp() override ( 
» collection.add(Tweet("msg", "Quser")); 
} 
}; 
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但 是 在 IgnoresDuplicateTweetAdded 测 试 中 创建 第 二 个 Tweet 对 象 时 ， 需 要 引用 这 个 tweet。 我 
们 想 在 ARetweetCollectionWithOneTweet 中 加 入 一 个 成 员 变量 。 这 意味 着 必须 将 之 声明 为 指针 类 
型 。 我 们 可 以 使 用 普通 的 C++ 指针 ， 并 在 teardown 函 数 中 删除 它 。 








c3/17/RetweetCollectionTest.cpp 


class ARetweetCollectionWithOneTweet: public Test ( 
public: 
RetweetCollection collection; 
Tweet* tweet; 
void SetUp() override { 
tweet = new Tweet("msg", "Quser") 
collection.add(*tweet); 


H 


void TearDown() override { 
delete tweet; 
tweet - nullptr; 





} 
}; 
teardown 函 数 本 质 上 是 setup 函 数 的 道 过 程 。 每 个 测试 后 它 都 会 执行 一 次 ， 即 便当 测试 抛 出 异 
常 时 也 不 列 外 。 你 可 以 将 teardown 函 数 用 于 清理 工作 : 释放 内 存 (就 像 这 个 示例 中 一 样 )、 释 放 
开销 大 的 资源 ( 如 数据 库 连 接 )， 或 者 清理 一 些 其 他 的 状态 ， 例 如 存储 在 静态 变量 中 的 数据 。 
如 果 使 用 指针 ， 那 么 就 需要 稍微 改动 一 下 测试 ， 因 为 现在 tweet 变 量 是 指针 类 型 。 这 样 做 的 
好 处 是 可 以 将 测试 的 代码 从 五 行 缩 减 至 三 行 ， 而 依然 可 以 反映 我 们 需要 测试 的 东西 。 















































c3/17/RetweetCollectionTest.cpp 


TEST F(ARetweetCollectionWithOneTweet, IgnoresDuplicateTweetAdded) ( 
» Tweet duplicate(*tweet); 
collection.add(duplicate); 


ASSERT THAT(collection.size(), Eq(1u)); 
} 


下 面 的 fixture 版 本 使 用 了 智能 指针 : 


c3/18/RetweetCollectionTest.cpp 
class ARetweetCollectionWithOneTweet: public Test ( 
public: 
RetweetCollection collection; 
» shared ptr«Tweet» tweet; 


void SetUp() override ( 


» tweet = shared ptr«Tweet»(new Tweet("msg", "Quser")); 
collection.add(*tweet); 


}; 
初始 化 的 代码 适用 于 所 有 相关 的 测试 。 如 果 只 用 少数 几 个 测试 来 设置 上 下 文 反而 容易 造成 不 
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必要 的 困惑 。 当 一 些 测试 需要 一 个 tweet， 而 其 他 测试 不 需要 时 ,最 好 再 创建 一 个 fixture， 并 且 把 


测试 合理 地 分 开 。 



































在 创建 额外 的 fixture 时 ， 不 要 犹豫 。 但 是 每 创建 一 个 fixture， 判 断 一 下 是 不 是 需要 显现 出 产 
品 代码 中 的 设计 缺陷 。 如 果 需 要 两 个 不 同 的 fixture 的 话 ， 这 有 可 能 意味 着 你 正在 测试 的 类 违反 了 














一 责任 原则 ， 你 可 能 需要 将 它们 拆 分 为 两 个 类 。 


4.2.4 Arrange-Act- 


Assert/Given-When-Then 


测试 都 有 相同 的 流程 。 首 先 需要 设置 好 合适 的 条 件 ， 然 后 执行 代表 要 验证 的 行为 的 代码 , 最 











后 验证 结果 是 否 和 期 望 的 一 样 。( 有 些 测试 可 能 需要 一 些 清 理工 作 。 例 如 ， 一 个 测试 可 能 需要 关 





闭 之 前 打开 的 数据 库 连 接 。) 
测试 应 当 尽 可 能 地 直接 反映 其 测试 意图 , 这 就 意味 着 阅读 测试 的 人 不 需要 细 细 品读 测试 中 的 








每 一 行 ， 就 能 很 容易 地 形 








E 解 测试 的 基本 构成 : 测试 的 初始 化 ( Arrange )、 测 试 的 行为 ( Act )， 以 


及 怎样 验证 行为 结果 (Assert )。 


Arrange, Act, Assert 





(AAA, 通常 读 作 triple-A ) 助 记 词 是 由 Bil Wake "发 明 的 ， 它 提醒 你 直 








观 地 去 组 织 测试 以 便 能 够 快速 阅读 。 看 看 下 面 的 测试 , 你 能 快速 看 出 哪些 代码 行 是 用 于 设置 上 下 
文 的 ， 哪 些 是 用 来 执行 所 要 验证 的 行为 的 ， 哪 些 是 和 真正 的 断言 相关 的 吗 ? 














c3/14/RetweetCollectionTest.cpp 
TEST F(ARetweetCollection, IgnoresDuplicateTweetAdded) { 


Tweet tweet("msg" 


, "Quser"); 


Tweet duplicate(tweet); 
collection.add(tweet); 
collection.add(duplicate); 

ASSERT THAT(collection.size(), Eq(1u)); 


} 


n RF CHE TEX, 那么 就 需要 多 花 些 时 间 来 看 清楚 它们 到 底 在 测试 什么 。 现 在 来 对 比 
一 下 将 Arrange、Act、Assert 区 分 开 的 版 本 。 





c3/13/RetweetCollectionTest.cpp 
TEST F(ARetweetCollection, IgnoresDuplicateTweetAdded) { 


Tweet tweet("msg" 


, "Quser"); 


Tweet duplicate(tweet); 
collection.add(tweet); 


collection.add(duplicate); 


ASSERT THAT(collection.size(), Eq(1u)); 


} 





(D http://xp123.com/articles/3a-arrange-act-assert 
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一 些 测 试 驱 动 开发 者 喜欢 助 记 词 Given-When-Then。 给 定 ( Given ) 一 个 上 下 文 ， 当 (When ) 
测试 调用 一 些 行为 ， 然 后 (Then ) 验证 结果 。( 清理 工作 不 能 作为 助 记 词 的 一 部 分 ， 因 为 此 工作 
对 理解 测试 验证 的 行为 意义 不 大 。) 你 也 可 能 听 过 Setup-Execute-Verify ( -Teardown ) 这 样 的 表述 。 
Given-When-Then 表 述 法 稍微 侧重 强调 验证 行为 ， 而 非 测试 执行 。 这 也 和 验收 测试 驱动 开发 
( Acceptance Test-Driven Development, ATDD ) 中 的 概念 吻合 (参见 10.3 节 )。 


AAA 并 不 是 让 人 脑 洞 大 开 的 理念 ， 但 是 如 果 一 直 使 用 它 ， 会 让 阅读 测试 的 人 轻松 一 些 。 
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如 果 你 编写 的 是 小 而 独立 的 代码 单元 , 那么 每 个 测试 都 会 运行 得 快 如 闪电 。 通常 一 个 测试 在 
一 台 配 置 完备 的 电脑 上 的 运行 时 间 不 到 一 训 秒 。 以 这 种 速度 , 几 分 钟 内 至 少 可 以 运行 几 千 个 测试 。 

如 果 与 一 些 外 部 慢 速 资源 C 如 数据 库 或 其 他 慢 速 服务 ) 交互 的 话 ,那么 测试 就 会 变 慢 。 单 单 
建立 数据 库 连 接 就 可 能 花费 50 毫 秒 。 如 果 大 部 分 测试 必须 与 数据 库 交 互 , 那么 需要 几 分 钟 才 能 运 
行 完 几 千 个 测试 。 有 些 工作 室 需 要 半 个 多 小 时 才能 运行 完 所 有 测试 。 

我 们 将 在 第 5 章 中 学 习 怎 样 打 破 对 慢 速 组 件 的 依赖 。 为 什么 构建 快速 的 测试 可 以 决定 能 否 成 
功 运 用 TDD 呢 ? 

TDD 的 核心 目标 就 是 尽 可 能 频繁 地 获得 较 多 的 反馈 。 当 你 修改 了 一 点 代码 时 , 会 想 马 上 知道 
改动 是 否 正确 。 你 是 和 否 破坏 了 某 处 的 代码 呢 ? 


你 每 做 出 一 次 小 的 改动 , 都 需要 运行 所 有 的 单元 测试 。TDD 最 大 的 好 处 是 它 能 让 你 在 短 时 间 
内 获得 有 用 的 反馈 。 如 果 构 建 的 测试 运行 得 快 , 那么 如 前 所 述 , 完全 有 可 能 在 几 秒 内 运行 完 所 有 
的 测试 。 如 果 等 待 的 时 间 足 够 得， 那么 经 常 运 行 所 有 的 测试 也 是 合理 的 。 

如 果 运 行 完 所 有 的 测试 需要 的 时 间 不 止 数秒 , 那么 就 不 要 频繁 地 运行 它们 。 如 果 测 试 需要 运 
行 两 分 钟 , 你 会 多 久 运行 一 次 呢 ?” 或 许 1 小 时 5 次 。 如 果 需 要 20 分 钟 呢 ?” 可 能 一 天 运行 的 次 数据 手 
指 都 能 数 过 来 了 吧 ! 

一 旦 反馈 周期 变 长 ,TDD 的 威力 就 会 减弱 。 获 取 反 馈 的 间隔 时 间 越 长 , 那么 你 写 的 代码 出 问 
题 的 可 能 性 就 越 大 。 通 常 在 编写 代码 时 很 容易 引入 或 大 或 小 的 问题 。 相 比 之 下 ,每 做 一 个 小 改动 
就 运行 一 次 测试 ， 就 能 逐个 解决 这 些 问 题 。 在 写 了 几 分 钟 的 代码 后 ， 如 果 测 试 发 现 了 问题 ， 你 能 
很 容易 地 定位 到 导致 该 问题 的 代码 。 如 果 你 编写 了 几 行 星 涩 难 懂 的 代码 , 那么 可 以 容易 且 安 全 地 
整理 它们 。 

运行 慢 的 测试 对 TDD 来 说 是 个 问题 , 所 以 一 些 人 不 再 把 它们 称 为 单元 测试 , 而 是 称 其 为 集成 
测试 (参见 10.3 节 )。 
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运行 测试 的 一 个 子 集 

你 可 能 已 经 有 一 个 测试 集 (Test suite ) 来 验证 系统 的 一 部 分 行为 。 这 些 测 试 很 有 可 能 运行 得 
不 是 很 快 ， 因 为 大 部 分 已 有 的 系统 都 依赖 于 许多 慢 速 协作 者 。 

我 们 对 于 运行 速度 较 慢 的 测试 集 的 第 一 反应 是 少 运行 几 次 。 如 果 你 想 要 做 测试 驱动 开发 , 那 
么 这 个 策略 是 行 不 通 的 。 我们 的 第 二 反应 是 只 运行 其 中 的 一 个 测试 子 集 。 虽然 这 个 方法 不 是 那么 
理想 ， 但 也 可 行 ， 前 提 是 了 解 其 背后 的 意义 。 

Google Mock 可 以 通过 指定 一 个 测试 过 滤器 轻松 地 做 到 只 运行 一 个 测试 子 集 。 你 可 以 把 测试 
滤 带 作为 执行 测试 的 命令 行 参数 。 过 滤器 的 语法 是 : 测试 用 例 名 .测试 名 称 。 例 如 ， 如 果 想 要 
行 一 个 特定 的 测试 ， 可 以 使 用 下 面 的 命令 : 

./test --gtest filter-ATweet.CanBeCopyConstructed # weak 

但 是 不 要 养 成 每 次 只 运行 一 个 测试 的 习惯 。 可 以 使 用 通配符 C0 运行 多 个 测试 。 让 我 们 运 
行 一 下 ATweet 测 试用 例 中 所 有 的 测试 。 

./test --gtest filter-ATweet.* # slightly less weak 


如 果 你 在 开发 和 tweet 相 关 的 类 ， 那 么 最 好 找到 一 个 方法 来 运行 所 有 和 tweet 相 关 的 测试 。 使 
用 多 个 通配符 吧 ! 


./test --gtest filter-*weet*.* 


这 个 过 滤 需 包含 了 RetweetCollection 中 所 有 的 测试 。( 我 省 略 写 T， 因 为 它 不 能 和 Retweet- 
Collection 中 的 小 写 t 匹 配 。) 


如 果 你 想 在 不 运行 Tweet 类 的 任何 构造 测试 的 情况 下 运行 和 tweet 相 关 的 所 有 测试 ， 该 怎么 做 
呢 ? 这 时 ，Google Mock 人 允许 你 创建 复杂 的 过 滤器 。 


./test --gtest filter-*Retweet*.*:ATweet.*:-ATweet*.*Construct* 


可 以 使 用 冒号 ( : ) 来 分 隔 不 同 的 过 滤器 。 如 果 Google Mocki $I—^4 fa^ (- )， 那么 其 后 的 
所 有 过 滤器 匹配 的 测试 都 将 被 忽略 。 在 上 面 的 例子 中 , -ATweet*.*Construct* 告 诉 Google Mock 
忽略 名 称 中 含 Construct 的 所 有 ATweet 测 试 。 

只 运行 一 个 测试 子 集会 出 现 什 么 问题 呢 ? 你 在 短 时 间 内 运行 的 测试 越 多 , 就 越 有 可 能 知道 什 
么 时 候 引 入 了 缺陷 。 运 行 的 测试 越 少 , 那么 找到 一 个 缺陷 的 平均 时 间 就 越 长 。 通 常 ,引入 一 个 缺 
陷 到 发 现 它 的 时 间 间 隔 越 长 ， 修 复 它 所 需 的 时 间 就 越久 。 原 因 很 简单 。 第 一 ， 如 果 这 段 期 间 你 做 
过 其 他 事情 , 那么 通常 需要 花费 额外 的 时 间 来 理解 原先 的 解决 方案 。 第 二 ， 新 增加 的 代码 会 增加 
理解 难度 和 修复 缺陷 的 难度 。 


许多 单元 测试 工具 (Google Mock 除 外 ) 直接 支持 永久 地 指定 任意 测试 集 。 例 如 ，CppUnit 
提供 了 一 个 TestSuite 类 ， 它 允许 你 以 编程 的 方式 向 一 个 测试 集合 中 加 入 测试 来 运行 。 
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测试 分 类 
最 近 , 我 在 为 一 个 客户 工作 , 他 们 有 一 个 相当 强大 的 C++ 系统 。 在 我 加 入 团队 之 前 ， 
他 们 刚刚 开始 使 用 TDD, 并 且 已 经 开发 了 几 百 个 测试 。 但 是 大 部 分 测试 运行 缓慢 ,运行 
完 所 有 测试 需要 大 约 3 分 钟 ， 对 于 这 个 测试 数目 来 说 ， 这 需要 的 时 间 过 长 。 大 部 分 测试 
会 花费 300 毫 秒 或 更 长 时 间 。 
我 们 在 Google Mock 的 基础 上 快速 地 实现 了 一 个 测试 监听 程序 ， 它 的 工作 就 是 生成 
一 个 名 为 slowTest.txt 的 文件 ， 其 中 包含 运行 超过 10 毫 秒 的 测试 名 称 列 表 。 然 后 ， 我 们 修 
改 Google Mock， 使 其 可 以 从 一 个 文件 中 读 入 一 些 过 滤器 。 这 个 改动 本 质 上 为 Google 
Mock 提 供 了 测试 集 支 持 。 此 外 ， 我 们 还 修改 了 Google Mock 来 支持 运行 一 个 过 滤器 的 相 
反 测 试 。 这 样 一 来 ， 既 可 以 使 用 slowTests.txt 运 行 慢 的 测试 ， 也 可 以 运行 快 的 测试 。 结 
果 是 慢 速 测试 集 花 费 了 三 分 钟 的 大 部 分 时 间 ( 参见 10.3 节 )， 而 快速 测试 集 只 花费 了 几 
秒 钟 。 
进一步 修改 Google Mock， 使 运行 时 间 超 过 给 定 值 的 测试 失败 (通过 一 个 名 为 
slow test threshold 的 命令 行 选项 ), 我 的 客户 把 这 些 都 配置 到 持续 集成 系统 中 ， 先 
运行 快速 测试 集 ， 运 行 得 太 慢 就 会 失败 ， 之 后 再 运行 慢 速 测试 集 。 
我 们 建议 程序 员 在 开发 过 程 中 不 断 地 运行 这 个 快速 测试 集 。 开发 人 员 在 运行 快速 测 
试 时 会 指定 一 个 slow_test threshold， 以 便 在 一 个 慢 速 测试 加 入 时 收 到 通知 。 一 旦 
要 提交 代码 , 就 需要 运行 慢 速 和 快速 测试 集 。 我 们 让 开发 者 想 办 法 消除 使 测试 运行 缓慢 
的 不 良 依赖 ， 以 此 不 断 地 减 小 slowTests.txt 的 大 小 (参见 第 5 章 )。 
这 个 团队 理解 了 怎么 去 做 ,并 且 最 终 大 部 分 测试 都 能 快速 运行 。 上 次 我 听 说 ,他 们 
已 经 成 功 地 快速 开发 系统 了 。 
我 已 经 通过 类 似 测试 分 类 的 流程 帮助 了 一 些 团 队 。 通 常 使 用 的 是 80-20 原 则 : 20% 的 
测试 花费 80% 的 运行 时 间 。 将 快速 测试 和 慢 速 测试 分 开 能 够 快速 提高 团队 的 TDD 能 
定义 测试 集 的 能 力 为 分 割 测试 提供 了 基础 , 这 样 就 可 以 只 运行 那些 速度 快 的 测试 。 发 现 慢 速 
的 测试 ， 就 可 以 逐渐 地 把 慢 速 测试 转换 为 快速 测试 。 
通常 ， 你 是 需要 集成 测试 (那些 必须 与 外 部 服务 集成 的 测试 ， 参 见 10.3 节 ) 的 。 这 些 测试 
运行 得 比较 慢 。 一 旦 你 拥有 自 定义 任意 测试 集 的 能 力 ， 就 可 以 维护 多 个 测试 集 ， 用 在 持续 集成 
过 程 中 。 
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断言 可 以 将 一 个 普通 的 测试 变 成 自动 化 的 测试 。 如 果 没 有 断言 ， 那 么 Google Mock 只 是 执行 
一 段 代码 而 已 。 如 果 想 要 验证 一 段 代 码 是 否 能 正确 工作 , 则 需要 人 工 查 看 结果 ( 可 以 通过 单 步调 
试 或 打印 出 变量 内 容 )。 


人 工 验 证 测试 结果 是 耗 时 的 。TDD 能 生成 自我 验证 的 (参见 7.2 节 ) 自动 化 的 单元 测试 ， 这 
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将 省 去 查看 结果 的 工作 。 人 工 查看 是 有 风险 的 ， 且 单调 乏味 。 没 有 比 人 工 为 应 用 程序 编写 GUI 更 
费时 间 的 事 了 ， 因 为 你 需要 一 次 又 一 次 地 去 验证 本 可 以 通过 单元 测试 自动 验证 的 东西 。 

当 测试 框架 运行 单个 测试 时 ， 它 会 从 头 到 尾 执行 测试 代码 段 中 的 语句 。 每 遇 到 一 个 断言 ， 都 
意味 着 要 去 验证 一 些 期 待 的 结果 。 如 果断 言 的 条 件 不 满足 ， 那 么 测试 框架 就 中 止 测试 。( 通常 ， 
断言 中 会 抛 出 测试 框架 可 以 捕获 的 异常 。) 测试 框架 会 保存 测试 失败 的 信息 ， 运 行 teardown 逻 辑 ， 
然后 接着 运行 下 一 个 测试 。 

有 些 工具 ， 包 括 Google Mock， 提 供 了 男 一 种 断言 机 制 ， 它 允许 测试 在 遇 到 断言 失败 的 情况 
下 继续 运行 。 这 些 断 言 又 称 作 非 致命 性 断言 ， 与 致命 性 断言 相对 ， 后 者 会 中 止 测试 。 

在 产品 测试 中 应 该 使 用 致命 性 断言 。 一 旦 断言 失败 就 应 该 中 止 测试 。 当 断言 验证 的 假设 失败 
时 ， 继 续 执行 测试 的 意义 不 大 。 如 果 追 求 一 个 测试 一 个 断言 (参见 7.3 节 )， 那 么 在 唯一 的 断言 后 
就 很 少 会 再 有 代码 了 。 

当 你 在 设计 测试 或 解读 测试 失败 时 , 很 有 可 能 用 到 额外 的 断言 来 用 作 探查 。 成员 变量 初始 化 
成 特定 的 值 了 吗 ? 配置 设 好 了 预先 的 状态 了 吗 ? 如 果 非 致命 性 断言 失败 了 ， 测 试 还 会 继续 运行 ， 
这 或 许 额 外 给 你 提供 了 一 些 有 用 的 信息 。 通 常 ， 在 准备 提交 代码 前 会 移 除 探查 时 用 的 断言 。 





















































































































































4.4.1 经 典 的 断言 形式 

大 部 分 测试 框架 都 支持 我 所 谓 的 经 典 断 言 形 式 。 它 们 沿袭 了 SUnit 风 格 ，SUnit 在 20 世 纪 90 年 
代 构 建 ， 是 Smalltalk 的 单元 测试 框架 。 使 用 这 种 形式 并 无 不 妥 , 但 是 你 或 许 会 考虑 形式 更 加 多 样 
的 断言 形式 ， 即 Hamcrest 断 言 (参见 4.2.2 节 )。 由 于 你 会 遇 到 大 量 使 用 经 典 断 言 形式 的 代码 ， 
此 学 习 这 两 类 断言 是 十 分 必要 的 。 

下 表 列 出 了 Google Mock 中 的 两 个 主要 断言 。 其 他 框架 也 会 使 用 类 似 的 名 称 。 





























形 R 描 xk m A 
ASSERT TRUE( 表 达 式 ) 表达 式 返回 假 (或 0) 时 ， 测 试 失败 ASSERT_TRUE(4<7)} 
ASSERT_EQ( 期 待 值 ， 实 际 值 ) 胃 待 值 和 实际 值 不 等 时 ， 测 试 失败 ASSERT EQ(4, 20/5) 








Google Mock 和 大 多 数 C++ 单元 测试 框架 一 样 ， 通 过 宏 来 实现 断言 的 行为 。 通 常 都 要 经 过 重 
载 来 实现 相等 的 断言 ， 用 来 支持 所 有 的 基本 类 型 比较 。 

大 部 分 测试 框架 会 提供 一 些 额外 的 断言 形式 来 提升 表达 力 。 例 如 ，Google Mock 支 持 
ASSERT FALSE ( 当 表 达 式 返回 假 时 ， 断 言 成 立 ) 和 一 些 关系 型 断言 ， 如 ASSERT GT ( 当 第 一 个 
参数 大 于 第 二 个 参数 时 ,断言 成 立 )。 可 以 用 ASSERT_LT(4, 7) 来 替代 上 表 中 的 第 一 个 断言 示例 。 

















4.4.2 Hamcrest 断言 
单元 测试 工具 提供 了 一 个 小 且 固 定 的 经 典 断 言 集合 。 大 部 分 常用 的 断言 ， 如 比较 两 个 值 相等 
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( Google Mock 中 的 ASSERT_EQ )， 是 符合 习惯 的 用 法 。 你 一 定 要 把 期 望 值 放 在 前 面 。 如 果 你 要 大 
声 朗 读 一 个 断言 ， 大 至 是 这 样 的 : 断定 期 望 值 5 等 于 实际 值 x。 这 没什么 的 ， 因 为 你 日 后 将 阅读 成 
千 上 万 个 这 样 的 断言 , 但 是 这 种 表达 会 稍微 影响 测试 的 可 读 性 。 同 时 ,对 于 初学 者 来 说 也 容易 误 
将 实际 值 和 期 望 值 弄 反 。 

几 年 前 引入 Hamcrest 断 言 就 是 为 了 提升 测试 的 表达 力 、 创 建 复杂 断言 的 灵活 性 ， 以 及 测试 错 
误 所 提供 的 信息 。Hamcrest 使 用 匹配 器 ( matcher，Hamcrest 是 Matchers 的 衍生 词 ) 比较 实际 结果 。 
匹配 器 可 以 组 合成 复杂 但 易 懂 的 比较 表达 式 。 你 也 可 以 自 定 义 匹配 吉 。 

几 个 简单 的 示例 胜 过 千言 万 语 ， 至 少 可 以 省 去 不 少 篇 幅 。 


string actual = string("al") + "pha"; 
ASSERT THAT(actual, Eq("alpha")); 


这 个 断言 从 左 至 右 读 作 : 断定 实际 值 等 于 "aLpha"。 对 于 一 个 简单 的 相等 比较 而 言 ， 区 区 几 
个 额外 的 字符 就 能 够 提升 可 阅读 性 。 
起 初 ，Hamcrest 汤 言 貌 似 过 于 炫 技 。 但 是 匹配 器 的 价值 在 于 它 能 极 大 地 提升 测试 的 表达 力 。 
许多 匹配 器 既 能 减少 所 需 的 代码 量 ， 同 时 也 能 提升 测试 的 抽象 层次 。 
ASSERT THAT(actual, StartsWith("alx")); 
Google Mock 的 文档 列 出 了 一 些 内 置 的 匹配 器 "。 
使 用 它们 时 需要 在 测试 文件 中 加 入 using 声 明 。 
using namespace ::testing; 
否则 本 意 用 来 提升 表达 力 的 断言 读 起 来 会 有 些 吧 唆 卡 顿 。 如 下 : 
ASSERT THAT(actual, ::testing::StartsWith("al")); 
HamcrestB zi EIER As WUR e R3 np ETE 77 EEK, 


Expected: starts with "alx" 
Actual: "alpha" (of type std::string) 


匹配 器 的 组 合 能 力 使 你 用 一 行 断言 就 能 表达 本 来 需要 多 行 断 言 才能 做 到 的 事情 。 


ASSERT THAT(actual, 
AllOf(StartsWith("al"), EndsWith("ha"), Ne("aloha"))); 


上 述 例子 中 的 ALLOf 表 明 只 有 当 所 有 匹配 器 都 成 功 时 ,整个 断言 才 算 通 过 。 因 而 actuat 必 须 
以 "at 开头 ， 以 "ha" 结 尾 ， 且 不 等 于 "aLoha'"。 


对 于 布尔 值 的 断言 而 言 ， 大 部 分 开发 者 都 会 避 开 Hamcrest 晰 言 而 使 用 经 典 的 断言 形式 。 


ASSERT TRUE(SomeBooLeanExpression) ; 
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ASSERT FALSE(someBooleanExpression); 


总 之 ， 如 果 Google Mock 内 置 的 匹配 器 不 能 满足 需求 ， 你 也 可 以 自 定义 匹配 器 ”。 





4.4.3 选择 正确 的 断言 

测试 中 断言 的 目标 是 清晰 地 描述 其 之 前 代码 执行 的 结果 是 否 满 足 期 望 值 。 通 党 ,断言 需要 明 
确 。 如 果 你 知道 一 个 变量 的 值 应 为 3， 那 么 就 使 用 相等 的 断言 来 准确 地 声明 。 

ASSERT THAT(tweetsAdded, Eq(3)); 

即使 弱化 一 点 的 比较 有 时 候 也 更 具 表 达 力 ， 但 是 大 部 分 时 候 还 是 要 避免 使 用 。 

ASSERT THAT(tweetsAdded, Gt(0)); // 避免 广泛 的 断言 


大 部 分 断言 都 应 该 使 用 相等 的 形式 。 从 技术 上 讲 ，ASSERT_TRUE 是 非常 普 适 的 , 但 是 当 断 言 
失败 时 , 相等 断言 (无论 是 不 是 Hamcrest ) 都 能 传递 更 好 的 信息 。 例 如 , 当下 面 的 断言 失败 时 ……: 


unsigned int tweetsAdded(5); 
ASSERT TRUE(tweetsAdded -- 3); 


失败 信息 提供 了 少量 的 信息 。 


Value of: tweetsAdded == 3 
Actual: false 
Expected: true 


但 是 如 果 使 用 下 面 的 形式 .…… 


ASSERT THAT(tweetsAdded, Eq(3)); 
失败 的 信息 会 告诉 你 断言 的 期 望 值 和 实际 值 。 


Value of: tweetsAdded 
Expected: is equal to 3 
Actual: 5 (of type unsigned int) 


错误 信息 中 的 序列 解释 了 为 什么 一 直 要 保持 期 望 值 和 实际 值 的 顺序 正确 。 如 果 一 不 小 心 把 顺 
序 弄 反 ， 就 会 出 现 令 人 混淆 的 错误 信息 ， 而 解读 此 信息 会 浪费 额外 的 时 间 。 如 果 使 用 
ASSERT THAT(), ， 那 么 实际 值 在 前 面 。 如 果 使 用 ASSERT_EQ() ， 那 么 期 望 值 在 前 面 。 











































































































4.4.4 浮 点 数 比 较 


浮 点 数 是 实数 的 二 进 制 表示 , 但 是 这 种 表示 是 不 准确 的 。 所 以 ,两 个 浮 点 数 计算 出 的 结果 有 
可 能 不 完全 相等 ， 即 便 它们 应 当 是 相等 的 。 下 面 是 一 个 例子 : 


double x{4.0}; 






































(D http://code.google.com/p/googlemock/wiki/V1 6 CheatSheet#Defining Matchers 
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double y{0.56}; 
ASSERT THAT(x * y, Eq(4.56)); 


在 我 的 机 器 上 会 收 到 下 面 的 错误 信息 : 


Value of: x + y 
Expected: is equal to 4.56 
Actual: 4.56 (of type double) 


Google Mock 和 其 他 工具 提供 了 特殊 的 断言 形式 ， 可 以 用 它们 来 比较 两 个 浮 点 数 ， 这 种 比较 
允许 有 一 定 的 误差 。 如 果 两 个 浮 点 数 的 差 大 于 这 个 误差 ， 那么 断言 失败 。Google Mock 提 供 了 基 
于 ULP ( Units in Last Place ) 的 简单 的 比较 方法 。 

ASSERT THAT(x + y, DoubleEq(4.56)); 

如 果 够 大 胆 ， 那 么 你 可 以 在 即将 发 布 的 下 一 版 Google Test 中 指定 误差 。ULP 和 浮 点 数 比 较 相 
对 来 说 是 复杂 的 话题 ( http://www.cygnus-software.com/papers/comparingfloats/comparingfloats. 
htm )。 



































4.4.5 ”基于 异常 的 测试 


优秀 的 工程 师 应 当知 晓 在 代码 执行 时 会 出 现 哪 些 错误 , 也 应 当知 道 什 么 时 候 抛 出 异常 , 什么 

寸 候 需 要 引入 try- catch 块 来 保护 应 用 程序 。 唯 有 对 代码 执行 路 径 了 如 指 掌 ， 方 能 知道 该 在 什么 
ESAE RR o 
在 TDD 中 ,， 先 从 一 个 失败 的 测试 开始 ,然后 将 对 异常 的 顾虑 化 作 代码 编写 人 系统 。 所 得 结 
就 是 可 以 用 作文 档 之 用 的 测试 , 可 以 将 此 测试 提供 给 不 太 清 楚 代码 执行 路 径 的 开发 人 员 。 当 异常 
发 和 后 时 , 可 以 在 测试 中 找到 可 能 出 错 的 地 方 和 将 会 发 生 的 事情 。 拥 有 这 些 知 识 的 客户 端 开 发 者 可 
以 很 自信 地 使 用 你 提供 的 类 。 

试想 你 现在 在 测试 一 段 代码 ， 它 在 某 些 情况 下 会 抛 出 异常 。 作 为 专业 人 员 , 你 的 工作 就 是 用 
一 个 测试 来 文档 化 这 种 情形 。 

有 些 单元 测试 框架 允许 你 声明 应 该 抛 出 的 异常 ,如果 异 常 没有 抛 出 , 则 测试 失败 。 使 用 Google 
Mock 可 以 编写 如 下 代码 : 








TE TM 















































c3/12/TweetTest.cpp 


TEST(ATweet, RequiresUserToStartWithAtSign) { 
string invalidUser("notStartingWithQ"); 
ASSERT ANY THROW(Tweet tweet("msg", invalidUser)); 
} 


如 有 果 ASSERT_ANY_TRHROW 宏 内 的 表达 式 不 抛 出 异常 ， 那 么 测试 失败 。 运 行 一 下 测试 就 会 得 
到 下 面 的 错误 信息 。 


Expected: Tweet tweet("msg", invalidUser) throws an exception. 
Actual: it doesn't. 
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下 面 是 让 这 个 测试 通过 的 相应 代码 。 


c3/12/Tweet.h 


Tweet(const std::string& message-"", 
const std::string& user-Tweet::NULL USER) 
: message (message) 


, user (user) { 
if (!isValid(user )) throw InvalidUserException(); 


) 


bool isValid(const std::string& user) const ( 
return 'Q' == user[0]; 


} 











(isValid() 的 实现 足够 让 这 个 测试 通过 了 。 这 个 实现 假设 Tweet 的 构造 函数 接受 一 个 空 字符 











串 作 为 user 的 实 参 。 那 么 ， 还 需要 我 们 写 什 么 测试 呢 ? ) 





如 果 你 知道 将 要 抛 出 异常 的 类 型 ， 那 么 可 以 指定 它 。 


c3/12/TweetTest.cpp 
TEST(ATweet, RequiresUserToStartWithAnAtSign) { 
string invalidUser("notStartingWithQ"); 


ASSERT THROW(Tweet tweet("msg", invalidUser), InvalidUserException); 
} 


下 面 的 错误 信息 会 告诉 你 当期 待 的 异常 类 型 和 实际 抛 出 的 不 一 致 时 会 是 怎样 的 。 
Expected: Tweet tweet("msg", invalidUser) throws an exception 


of type InvalidUserException. 
Actual: it throws a different type. 


如 果 你 的 单元 测试 框架 不 支持 确定 异常 抛 出 的 单行 断言 ,那么 也 可 以 在 测试 中 使 用 下 面 的 方法 。 

















c3/12/TweetTest.cpp 


TEST(ATweet, RequiresUserNameToStartWithAnAtSign) 1 
string invalidUser("notStartingWithQ"); 






























































try ( 
Tweet tweet("msg", invalidUser); 
FAIL(); 
} 
catch (const InvalidUserException& expected) {} 
} 
我 们 可 以 用 多 种 方法 达成 此 目的 , 但 我 还 是 喜欢 这 里 所 讲 的 技巧 。 这 是 TDD 社 区 所 喜好 的 惯 
用 法 。 如 果 必 须要 验证 异常 抛 出 后 的 条 件 ,， 那么 可 以 使 用 try-catch 块 。 例 如 ， 想 要 验证 异常 对 
象 的 文本 信息 。 
c3/13/TweetTest.cpp 


TEST(ATweet, RequiresUserNameToStartWithAtSign) { 


45 探查 私有 成 员 81 





string invalidUser("notStartingWithQ"); 
try ( 
Tweet tweet("msg", invalidUser); 
FAIL(); 
} 
catch (const InvalidUserException& expected) { 
ASSERT STREQ("notStartingWithg", expected.what()); 
} 
} 
注意 ASSERT_STREQ 的 用 法 。Google Mock 提 供 了 四 种 断言 宏 ( ASSERT_STREQ, ASSERT __ 
STRNE 、ASSERT_STRCASEEQ 和 ASSERT_STRCASENE )， 它 们 用 于 支持 C 风 格 ( 以 \0; 结 尾 ) 的 字符 


串 ， 即 char* 变 量 。 


4.5 探查 私有 成 员 


TDD 新 手 必 然 会 有 两 个 疑问 : 我 可 以 针对 私有 成 员 数据 编写 测试 吗 ? 私有 成 员 函 数 呢 ? 这 两 
个 既 相关 又 过 异 的 话题 会 影响 你 的 设计 抉择 。 


4.5.1. 私有 数据 


Tell-DontAsk 设 计 理 念 说 ,你 应 该 告诉 一 个 对 象 去 做 一 些 工作 , 然后 让 它 自主 完成 任务 。 如 
果 在 这 期 间 频 繁 地 过 问 对 象 , 那么 就 违反 了 Tell-Don'tAsk 原 则 。 如 果 一 个 系统 包含 大 量 的 对 象 查 
询 ， 它 是 纠缠 不 清 且 极 度 复杂 的 。 试 想 一 下 下 面 的 情形 : 客户 C 查 询 对 象 S 以 获取 信息 ， 然 后 做 
了 本 来 对 象 $S 可 以 完成 的 工作 ， 再 查询 一 下 对 象 S， 如 此 重复 。 这 使 客户 C 和 对 象 $ 之 间 紧 密 交 互 。 
因为 对 象 $ 并 没有 做 本 该 做 的 工作 ， 所 以 除 客户 C 之 外 的 其 他 客户 也 可 能 会 查询 相同 的 信息 ， 并 
使 用 重复 的 代码 逻辑 来 处 理 对 象 S 的 返回 信息 。 


通常 ， 当 一 个 对 象 被 要 求 完成 某 项 任务 时 ， 它 会 把 具体 工作 交 由 合作 对 象 来 处 理 。 相 应 地 ， 
可 以 用 一 个 测试 来 验证 这 个 交互 :合作 对 象 接受 到 信息 了 吗 ? 这 可 以 使 用 测试 替身 ( 参见 第 5 章 )。 
这 就 是 所 谓 的 交互 测试 。 

然而 , 并 不 是 所 有 的 交互 操作 都 需要 检测 合作 对 象 。 例如 ， 当 测试 驱动 开发 一 个 简单 的 容器 
时 ,你 会 想 要 验证 添加 进 其 内 的 任意 对 象 ,可 以 简单 地 通过 公共 接口 来 查询 并 用 断言 来 验证 答案 。 
验证 对 象 属性 的 测试 称 作 状态 测试 。 

让 客户 端 程序 知道 他 们 把 什么 添加 进 一 个 对 象 是 合理 的 。 加 一 个 访问 函数 。( 如 果 你 担心 恶 
意 客户 端 程序 通过 这 个 访问 函数 搞 破坏 的 话 ， 那 么 就 让 函数 返回 一 个 对 象 的 副本 。) 

极 少数 情况 下 需要 保存 一 些 中 间 计 算 的 结果 ,大 体 上 , 这 些 结果 是 调用 函数 产生 的 。 为 那些 
非 公用 接口 的 成 员 提供 访问 通道 是 可 以 接受 的 。 你 也 可 以 将 测试 声明 为 待 测试 类 的 友 元 , 但 不 要 
这 么 做 。 你 可 以 添加 简要 注释 来 说 明 你 的 意图 。 如 下 所 示 : 
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public: 
// 仅仅 为 了 测试 的 目的 而 暴露 数据 ; 避免 直接 用 于 生产 : 
unsigned int currentWeighting; 
将 数据 暴露 出 来 仅仅 是 为 了 测试 , 这 对 许多 人 来 说 是 不 易 接受 的 ， 
码 能 正常 工作 。 























但 更 重要 的 是 清楚 你 的 代 


然而 ， 过 量 的 状态 测试 显露 了 设计 坏 味 "。 无 论 什 么 时 候 ， 如 果 暴 露 数 据 仅仅 是 为 了 断言 ， 


那么 就 需要 考虑 用 验证 行为 的 方式 来 蔡 代 。 参 考 第 5 章 获取 更 多 信息 。 





4.5.2 ”私有 行为 


做 测试 驱动 开发 时 ,所 有 东西 都 来 自 于 类 的 公共 接口 设计 。 为 了 添加 详细 的 行为 ,你 测试 驱 
动 开发 这 个 行为 ， 就 好 像 你 的 测试 就 是 此 类 的 产品 客户 。 随 着 细节 越 来 越 多 和 代码 越 来 越 复 杂 ， 




















你 自然 就 会 觉得 需要 重 构 来 提取 其 他 的 方法 。 你 会 想 是 不 是 应 该 针对 这 
相应 的 测试 。 


例如 ， 一 个 图 书馆 系统 定义 了 一 个 HoLdingService 类 ， 它 提供 了 


文 些 提取 出 来 的 方法 直接 写 








图 书 的 借 出 和 归还 接口 。 


CheckIn() 方 法 为 图 书 的 归还 提供 了 合理 (但 有 点 乱 ) 的 高 层次 策略 实现 。 


c7/2/library/HoldingService.cpp 


void HoldingService::CheckIn( 
const string& barCode, date date, const string& branchId) 
1 
Branch branch(branchId); 
mBranchService.Find(branch); 


Holding holding(barCode); 
FindByBarCode (holding); 


holding.CheckIn(date, branch); 
mCatalog.Update(holding); 


Patron patronWithBook - FindPatron(holding); 
patronWithBook.ReturnHolding(holding); 


if (IsLate(holding, date)) 
ApplyFine(patronWithBook, holding); 


mPatronService.Update(patronWithBook); 
} 


























。 最 初 实现 CheckIn() 方 法 的 程序 员 





PERK H ApplyFine () PR 


数 
实现 开始 的 ， 但 是 在 情况 变 得 复杂 时 ， 提 取出 了 单独 的 函数 。 如 下 所 示 : 























CD 和 代码 坏 味 类 似 ， 设 计 坏 味 指 的 是 设计 里 存在 的 糟糕 方案 ,需要 改进 。 














是 从 只 考虑 一 种 情况 的 简单 
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c7/2/library/HoldingService.cpp 


void HoldingService::ApplyFine(Patron& patronWithHolding, Holding& holding) 


1 
int daysLate = CalculateDaysPastDue(holding); 


ClassificationService service; 
Book book = service.RetrieveDetails(holding.Classification()); 


switch (book.Type()) 1 
case Book: :TYPE BOOK: 
patronWithHolding.AddFine(Book::BOOK DAILY FINE * daysLate); 
break; 
case Book: :TYPE MOVIE: 
1 
int fine = 100 + Book::MOVIE DAILY FINE * daysLate; 
if (fine » 1000) 
fine - 1000; 
patronWithHolding.AddFine(fine); 
j 
break; 
case Book: :TYPE NEW RELEASE: 
patronWithHolding.AddFine(Book::NEW RELEASE DAILY FINE * daysLate); 
break; 


) 
围绕 AppLyFine() 的 每 个 测试 必须 在 一 个 上 下 文中 运行 ,这 就 需要 客户 先 借 出 一 本 书 ， 然 后 
再 归还 这 本 书 。 那 么 通过 直接 枚 举 测试 ApptyFine( ) 的 所 有 代码 路 径 岂 不 是 更 有 意义 ? 


我 们 应 该 认为 直接 为 ApplyFine() 写 测试 是 非常 不 好 的 ， 因 为 这 违反 了 信息 隐藏 的 原则 。 更 
重要 的 是 ， 我 们 应 该 察觉 到 示例 中 的 设计 缺陷 。AppLyFind() (还 违反 了 单一 责 任 原则 : 
HoldingService 应 该 只 为 客户 提供 高 层次 的 任务 步骤 。 每 一 个 任务 的 实现 细节 应 该 出 现在 其 他 地 方 。 
从 另外 一 个 角度 看 ，ApptLyFine() 还 犯 了 feature envy": 它 应 该 存在 于 另 一 个 类 ， 或 许 是 Patron 中 。 


大 多 数 时 候 ， 当 你 觉得 需要 测试 私有 行为 时 ,可 以 尝试 将 代码 移 到 男 一 个 类 或 为 之 创建 的 一 
个 新 类 。 

但 是 ,不 能 将 ApplyFine() 全 部 移 到 Patron 类 中 ， 因 为 它 做 了 多 件 事情 : 它 调用 了 另 一 个 函 
数 来 计算 图 书 过 期 天 数 ， 判 断 给 定 图 书 的 类 型 ， 并 计算 对 顾客 的 罚金 。 前 两 项 任务 需要 访问 
HoldingService 的 其 他 功能 ， 所 以 需要 暂时 保留 在 HoldingService 中 。 但 是 我 们 可 以 独立 计算 出 罚 
金 。 如 下 所 示 : 
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EL 





c7/3/library/HoldingService.cpp 


void HoldingService::ApplyFine(Patron& patronWithHolding, Holding& holding) 


1 
unsigned int daysLate = CalculateDaysPastDue(holding); 





CD feature envy, 译 为 “依恋 情结 ” ， 是 众多 代码 坏 味 中 的 一 种 ， 可 以 参考 《 重 构 》 一 书 。 
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ClassificationService service; 
Book book = service.RetrieveDetails(holding.Classification()); 
patronWithHolding.ApplyFine(book, daysLate); 

j 


c7/3llibrary/Patron.cpp 


void Patron::ApplyFine(Book& book, unsigned int daysLate) 
1 
switch (book.Type()) { 
case Book: :TYPE BOOK: 
AddFine(Book::BOOK DAILY FINE * daysLate); 
break; 


case Book: :TYPE MOVIE: 
i 
int fine = 100 + Book::MOVIE DAILY FINE * daysLate; 
if (fine » 1000) 
fine - 1000; 
AddFine(fine); 
} 


break; 


case Book::TYPE NEW RELEASE: 
AddFine(Book::NEW RELEASE DAILY FINE * daysLate); 
break; 


h 
} 


现在 我 们 再 来 看 一 下 移 到 新 地 方 后 的 函数 ， 貌 似 还 是 有 点 问题 。 查 询 图 书 类 型 还 是 有 点 
feature envy 嫌 疑 。switch 语 句 也 是 有 代码 坏 味 的。 用 多 态 来 取代 switch 使 得 我 们 可 以 创建 更 直 


接 且 更 有 针对 性 的 测试 。 但 目前 而 言 , 我 们 已 经 把 ApplyFine() 放 到 了 一 个 可 以 公开 直接 测试 它 
的 理想 位 置 。 
























































提问 : 如 果 这 样 编写 程序 的 话 ， 我 最 后 会 不 会 得 到 数 千 个 特定 功能 的 类 ? 

回答 : 当然 会 多 出 一 些 类 ,但 还 不 至 于 数 以 千 记 。 每 个 类 会 非常 小 ， 这样 也 易于 理 
解 /测试 /维护 ， 编 译 也 很 快 ! (参见 4.3 节 。) 

提问 : 我 不 提倡 创建 更 多 的 类 。 

回答 : 这 时 你 就 开始 真正 利用 OO ( Object-Oriented， 面 向 对 象 ) 了 。 当 你 创建 更 多 单 
一 目标 的 类 并 且 每 个 类 包含 一 些 单一 责任 的 方法 时 ， 你 会 发 现 更 多 的 重用 契机 。 重 用 一 
个 庞杂 的 类 是 不 可 能 的 。 相 反 ， 遵 循 单 一 责任 原则 的 类 会 让 你 看 到 减少 代码 量 的 可 能 性 。 


如 果 你 面 对 的 是 遗留 代码 呢 ? 假设 你 要 先 从 一 个 有 几 十 个 成 员 函 数 的 类 下 手 , 其 中 许多 还 是 
私有 上 成员。 这 跟 私 有 行为 类 似 ， 可 以 先 简单 地 弱化 访问 关系 ， 并 为 一 些 私有 函数 添加 相应 测试 。 
(再 一 次 提醒 ， 不 要 担心 类 的 泛滥 ， 这 不 会 发 生 。) 将 函数 移 至 更 好 的 场所 。 你 可 以 参见 第 5 章 来 
获得 解决 遗留 系统 的 良 方 。 
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4.6 ”测试 和 测试 驱动 : 参数 化 的 测试 及 其 他 方法 


尽管 测试 驱动 开发 中 有 测试 两 个 字 ， 但 是 它 更 多 地 与 设计 有 关 ， 而 非 测 试 。 在 TDD 过 程 中 ， 
你 会 编写 单元 测试 , 但 它们 基本 就 是 一 些 副产品 。 貌似 差别 不 大 , 但 TDD 的 真正 目的 是 让 你 一 直 
保持 设计 整洁 ， 这 样 在 引入 新 的 行为 或 改变 现 有 行为 时 ， 你 会 更 从 容 自信 ， 并 且 不 会 太 费 力 。 

从 测试 的 角度 看 ， 你 寻求 的 是 创建 具有 高 覆盖 率 的 测试 。 所 写 的 测试 有 五 类 : J (zero). 
有 (one )、 多 (many )、 边 界 ( boundary ) 和 异常 ( exceptional ) 情形 。 而 从 测试 驱动 角度 来 看 ， 
你 写 测试 的 目的 是 为 了 保证 代码 能 够 符合 预定 规范 。 虽然 测试 和 测试 驱动 都 能 够 保证 你 有 足够 的 
信心 去 发 布 代码 , 但 是 一 旦 对 所 构建 的 东西 有 足够 的 信心 ， 就 可 以 停止 TDD。 与 此 相反 ,优秀 的 
测试 人 员 会 竭尽 所 能 地 去 覆盖 上 面 所 说 的 五 类 情形 。 

你 可 以 在 测试 驱动 开发 时 编写 额外 的 事后 测试 。 但 通常 而 言 , 一 旦 你 认为 你 有 一 个 正确 且 干 
净 的 实现 ,并 且 这 个 实现 能 覆盖 你 要 支持 的 情形 ,那么 就 可 以 立刻 停止 。 换 名 话说 ,在 你 想 不 出 
可 以 写 出 不 能 通过 的 测试 时 ， 就 可 以 停止 。 

现在 以 罗马 数字 转换 器 ( 参见 附录 B ) 为 例 ， 它 可 以 将 阿拉 伯 数 字 转 换 为 对 应 的 罗马 数字 。 
优秀 的 测试 人 员 可 能 至 少 会 测试 几 十 个 转换 ， 以 确保 能 覆盖 各 种 数字 和 组 合 。 相 反 , 在 测试 驱动 
开发 解决 方案 时 , 我 在 测试 完 十 几 个 转换 后 就 可 以 停 下 来 。 此 时 , 我 有 足够 的 信心 保证 你 已 经 开 
发 出 了 正确 的 算法 ， 剩 下 的 工作 仅仅 是 完成 阿拉 伯 数 字 到 罗马 数字 的 转换 表 。( 在 附录 中 ， 我 测 
试 驱动 开发 了 更 多 的 断言 ， 以 达到 提升 信心 和 示范 的 目的 。) 

许多 代码 级 的 测试 工具 起 初 都 是 用 来 支持 写 测 试 而 不 是 用 来 做 TDD 的 。 所 以 , 许多 工具 提供 
了 复杂 的 特性 ， 以 便 让 测试 变 得 更 简单 。 例 如 ,一 些 工 具 人 允许 你 在 测试 间 定 义 依赖 关系 。 如 果 你 
有 一 个 运行 很 慢 的 集成 测试 集 (参见 10.3 节 )， 那 么 这 确实 是 个 很 好 的 优化 特性 ， 可 以 把 测试 按 
照 一 定 的 顺序 组 织 起 来 以 便 加 快 测试 运行 。( 维护 这 种 紧密 耦合 在 一 起 的 测试 的 成 本 也 将 增加 。) 
但 是 ， 在 测试 驱动 开发 时 ， 你 追求 的 是 快速 且 独 立 的 测试 ， 所 以 不 需要 这 种 测试 间 的 依赖 关系 ， 
因为 它 会 让 事情 变 得 复杂 。 

偶尔 需要 或 使 用 这 些 偏 测试 的 特性 也 没什么 不 妥 之 处 。 但 是 , 使 用 前 先 问 自己 几 个 问题 : 这 
个 特性 是 不 是 让 我 偏离 了 测试 驱动 开发 ? 这 个 特性 和 TDD 的 目标 吻合 吗 ? 

本 节 将 大 致 描述 几 个 有 吸引 力 的 测试 工具 的 特性 。 如 果 很 想 使 用 它们 C 即便 在 我 劝说 你 不 要 
使 用 之 后 )， 那 么 可 以 参考 手头 的 测试 工具 来 了 解 特性 的 细节 信息 。 

































































































































































4.6.1 参数 化 测试 

罗马 数字 转换 器 ( 参见 附录 B ) 必须 转换 1~3999 的 数字 。 如 果 可 以 简单 地 遍历 一 系列 期 望 的 
输入 和 输出 ,并 把 它们 灌 进 一 个 能 够 接受 一 个 输入 和 一 个 输出 作为 参数 的 测试 , 这样 也 不 错 。 一 
些 测试 工具 ( 包括 Google Mock ) 的 参数 化 测试 特性 就 可 以 做 到 这 一 点 。 
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下 面 通过 一 个 简单 的 名 为 Adder 的 类 来 说 明 : 

















c3/18/ParameterizedTest.cpp 
class Adder { 
public: 
static int sum(int a, int b) { 
return a + b; 
} 
}; 


下 面 是 一 个 常规 情况 下 测试 驱动 过 程 产 生 的 测试 ， 它 驱动 了 sum( ) 的 实现 : 





c3/18/ParameterizedTest.cpp 


TEST(AnAdder, GeneratesASumFromTwoNumbers) 1 
ASSERT THAT(Adder::sum(1, 1), Eq(2)); 
j 


但 是 上 述 测试 只 覆盖 了 一 种 情形 ! 没 错 ,我 们 要 对 自己 的 代码 有 信心 , 不 需要 创建 一 堆 额 外 
的 测试 。 

对 于 更 复杂 的 代码 ， 或许 有 着 覆盖 一 大 堆 情 形 的 测 试 会 让 我 们 更 有 信心 。 对 于 Adder 而 言 ， 
我 们 可 以 先 定义 一 个 衍生 自 TestWithParam<T> 的 fixture， 这 里 的 T 是 参数 类 型 。 




















c3/18/ParameterizedTest.cpp 


class AnAdder: public TestWithParam«SumCase» { 
}; 


这 里 的 参数 类 型 为 SumCase， 用 来 描述 两 个 输入 值 和 一 个 期 望 的 和 。 


c3/18/ParameterizedTest.cpp 


struct SumCase { 
int a, b, expected; 
SumCase(int anA, int aB, int anExpected) 
: a(anA), b(aB), expected(anExpected) {} 
}; 


有 了 这 些 ， 就 可 以 写 参数 化 的 测试 了 。 我 们 使 用 TEST_P 宏 来 声明 测试 ， 其 中 P 表 示 参 数 化 。 


c3/18/ParameterizedTest.cpp 


TEST P(AnAdder, GeneratesLotsOfSumsFromTwoNumbers) { 
SumCase input = GetParam(); 
ASSERT THAT(Adder::sum(input.a, input.b), Eq(input.expected)); 
} 
SumCase sums[] = { 
SumCase(1, 1, 2), 
SumCase(1, 2, 3), 
SumCase(2, 2, 4) 
}; 
INSTANTIATE TEST CASE P(BulkTest, AnAdder, ValuesIn(sums)); 
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最 后 一 行 代 码 使 用 事先 准备 好 的 参数 运行 测试 。INSTANTIATE_TEST_CASE_P 的 第 二 个 参数 
是 fixture 的 名 称 , 第 三 个 参数 是 准备 好 的 测试 值 。( 第 一 个 参数 BuLkTest 是 Google Mock 加 在 测试 
名 称 前 的 前 级 。) VatuesIn() 函数 指示 在 每 次 运行 测试 时 , 其 输入 的 测试 值 是 来 自 名 为 sums 的 数 
组 ( GeneratesLotsOfSumsFromTwoNumbers )。 测 试 中 的 第 一 行 调用 了 GetParam( ) 函数 ， 它 返回 
输入 的 测试 值 ( 一 个 SumCase 对 象 )。 


酷 ! 但 是 我 做 了 十 多 年 的 TDD， 却 很 少 使 用 参数 化 测试 。 如 果 你 需要 测试 大 量 的 简单 数据 ， 
那么 参数 化 测试 可 能 是 一 个 很 好 的 选择 。 例 如 ， 某 个 人 给 你 一 个 充满 了 数据 的 电子 表格 。 你 可 能 
会 把 这 些 值 作为 参数 (甚至 可 以 写 点 代码 直接 从 电子 表格 中 抓 取 数 据 )。 这 都 是 很 好 的 主意 ,但 
是 一 旦 使 用 参数 化 测试 ， 你 将 感受 不 到 TDD 的 乐趣 。 


此 外 , 你 要 记 住 TDD 的 目标 是 让 测试 以 示例 的 方式 记录 系统 行为 , 每 个 测试 都 经 过 恰当 的 命 
名 来 描述 每 个 行为 。 虽 然 参数 化 测试 能 够 满足 这 样 的 要 求 ， 但 通常 它们 仅仅 是 测试 而 已 。 
























































4.6.2 测试 中 的 注释 


流行 的 测试 工具 都 会 带 有 一 些 代码 示例 ,以 作为 发 布 包 的 一 部 分 。 这些 代码 中 有 许多 注释 详 
尽 的 测试 。 注 释 大 概 形式 如 下 ， 带 点 学 究 气 。 





// Tests the c'tor that accepts a C string. 
TEST(MyString, ConstructorFromCString) 


这 样 的 注释 看 起 来 让 人 感到 不 舒服， 因为 注释 的 意思 和 代码 非常 接近 。 对 写 代 码 的 人 来 说 ， 
这 浪费 了 精力 和 页 面 的 空间 ; 对 于 阅读 代码 的 人 而 言 ， 则 是 浪费 阅读 时 间 。 

当然 , 注释 不 是 测试 工具 的 特性 而 是 一 个 语言 特性 。 在 产品 代码 和 测试 代码 中 , 最 好 的 选择 
是 尽量 将 注释 化 为 更 具 表 达 力 的 代码 。 所 剩 的 注释 只 回答 类 似 下 面 的 问题 : 为 什么 我 会 这 样 编写 
代码 ? 

除了 回答 此 类 “为 什么 2”， 如 果 你 要 加 注释 来 前 明 测 试 的 话 ， 那 就 糟糕 透顶 了 。 测 试 应 当 清 
楚 地 阐明 类 的 功能 。 你 总 是 可 以 用 一 种 无 需 使 用 曾 述 性 注释 的 方法 来 重 命名 和 组 织 测 试 (参见 
4.2.4 节 和 7.3 节 )。 

可 以 用 一 句 话 把 这 一 点 说 得 更 清楚 : 不 要 用 描述 性 的 注释 来 总 结 测试 , 而 是 修改 测试 名 称 以 
达到 描述 效果 。 不 要 引导 读者 通过 注释 来 理解 测试 。 要 整理 测试 中 的 步骤 。 




























































































4.7 ”结束 语 


在 学 完 本 章 中 构建 测试 的 方法 和 上 一 章 中 关于 TDD 的 概念 之 后 ， 你 就 可 以 应 对 更 难 的 问题 
了 。 例如 : 怎样 为 一 个 必须 与 其 他 对 象 交 互 的 对 象 写 测试 , 尤其 是 这 些 对 象 对 外 部 的 依赖 比较 麻 
烦 时 ? 
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5.1 开场 白 


在 前 面 三 章 中 我 们 测试 驱动 开发 了 一 个 独立 的 类 , 也 学 习 了 TDD 的 所 有 基础 内 容 。 生活 要 是 
如 此 简单 就 好 了 ! 事实 是 , 在 真实 的 面向 对 象 系统 中 对 象 必须 协同 工作 。 有 时 候 , 依赖 合作 对 象 
会 让 TDD 变 得 举步维艰 : 它们 可 能 很 慢 、 不 稳定 ， 或 者 帮 不 到 你 。 

在 本 章 中 你 将 学 习 怎样 使 用 测试 蔡 身 ( test double ) "去 解决 这 些 难 题 。 首 先 ， 你 将 学 习 怎 样 
利用 手工 打造 的 测试 替身 去 解除 依赖 。 其 次 , 你 将 学 习 怎样 利用 工具 来 简化 测试 蔡 身 的 创建 。 你 
会 学 到 多 种 设置 代码 的 方法 以 便利 用 测试 蔡 身 (又 称 作 注 入 技术 )。 最后， 你 将 了 解 使 用 测试 蔡 
身 给 设计 带 来 的 影响 ， 以 及 充分 利用 测试 蔡 身 的 策略 。 
































5.2 ”依赖 问题 


通常 ， 对 象 之 间 需 要 协同 工作 才能 完成 任务 。 一 个 对 象 通知 另 一 个 对 象 完成 某 件 事 ， 或 者 从 
男 一 个 对 象 获取 一 些 信息 。 如 果 对 象 A 为 了 完成 它 的 工作 需要 与 对 象 B 协 同 工 作 ， 那 么 我 们 就 说 
对 象 A 依赖 对 象 B。 





m^. 位 置 描述 服务 
作为 一 个 地 图 应 用 开发 人 员 , 我 需要 这 样 的 服务 ,， 即 它 能 基于 给 定 的 位 置 
(经 纬度 ) 返回 一 行 信息 来 描述 离 它 最 近 的 地 方 。 
构建 位 置 描述 服务 中 一 个 重要 的 工作 就 是 去 调用 一 个 外 部 API， 这 个 API 能 接受 一 个 位 置信 
息 ， 并 返回 位 置 数据 。 我 找到 了 一 个 开放 且 免 费 的 REST (Representational State Transfer ， 表 述 性 























CD 测试 蔡 身 译 法 取 自 电影 制作 中 的 特 型 蔡 身 。 例 如 ， 一 个 演员 可 能 在 武术 动作 方面 不 过 关 ， 这 时 候 就 要 找 一 个 专业 
的 武术 运动 员 帮 助 其 完成 动作 。 译 者 注 

@) story。 在 敏捷 开发 中 ， 一 般 使 用 一 段 描述 性 的 话 来 表达 需求 ， 这 叫 作 一 个 User Story， 又 可 称 为 Scenario。 本 书 中 
将 之 译 为 场景 。 一 一 译 者 注 
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状态 转移 ) 服务 ， 给 定 一 个 GETURL, 它 会 以 JSON 格 式 返 回 位 置 数 据 。 这 个 Nominatim 搜 索 服务 
是 Open MapQuest API 的 一 部 分 ?。 

测试 驱动 开发 位 置 描 述 服务 会 遇 到 一 个 难题 。 至 少 出 于 以 下 几 点 原因 ， 对 REST 调 用 的 依赖 
会 成 为 一 个 问题 。 

口 通过 一 个 HTTP 来 调用 REST 服 务 非常 缓慢 ， 这 也 导致 测试 的 运行 速度 变 慢 ( 参见 4.3 节 )。 
口 REST 服 务 可 能 不 是 一 直 处 于 可 用 状态 。 
口 REST 服 务 返 回 的 结果 得 不 到 保证 。 

为 什么 这 些 依赖 会 使 得 测试 变 得 困难 呢 ? 首先 , 依赖 一 个 慢 速 的 协作 对 象 会 让 测试 慢 得 难以 
忍受 。 其 次 ,依赖 一 个 不 稳定 的 服务 ( 要 么 不 可 用 ， 要 么 每 次 返回 不 同 的 结果 ) 会 导致 测试 间断 
性 地 失败 。 

完全 出 于 存在 性 来 讲 ， 则 会 出 现 依赖 。 如 果 你 没有 支持 发 起 HTTP 调 用 的 工具 代码 呢 ? 在 一 
个 团队 中 ， 设 计 并 实现 一 个 正确 的 HTTP 工 具 类 或 许 是 别人 的 工作 内 容 。 你 没有 时 间 去 等 他 完成 
这 个 工作 ， 也 没 时 间 自 己 去 实现 一 个 HTTP 类 。 

如 果 你 就 是 那个 负责 编写 HTTP 类 的 人 呢 ? 或 许 你 想 先 探索 一 下 位 置 描述 服务 的 整体 设计 实 
现 ， 然 后 再 考虑 HTTP 工 具 类 的 具体 实现 细节 。 



















































































5.3 测试 替身 


在 上 面 提 到 的 情形 中 , 你 可 以 使 用 测试 蔡 身 来 避免 被 这 类 问题 挡住 去 路 。 测试 替身 起 到 代替 
的 作用 : 一 个 doppelginger (字面 意思 是 double walker )， 它 代替 了 实际 产品 代码 中 的 类 。HTTP 
给 你 带 来 麻烦 了 吗 ? 如 果 答 案 是 肯定 的 ， 那 就 创建 HTTP 的 测试 蔡 身 吧 ! 测试 替身 的 工作 是 满足 
测试 所 需 。 当 客户 提交 一 个 GET 请 求 至 HITP 对 象 时 ， 测 试 替 身 能 够 返回 预先 准备 的 响应 。 测 试 
替身 应 该 返回 什么 是 由 测试 自己 决定 的 。 

想象 一 下 你 正 负责 构建 一 个 服务 ， 但 是 当下 并 不 考虑 单元 测试 〈 或 许 你 计划 写 一 个 集成 测 
试 )。 有 下 面 几 个 可 以 重用 的 类 供 你 选用 。 
O CurlHttp, 它 使 用 cURL” 发 起 HTTP 请 求 。 这 个 类 派生 自 纯 虚 基 类 Http, 这 个 基 类 定义 两 个 
函数 : get( ) 和 initialize()。 客 户 端 代码 在 调用 get ( ) 前 必须 先 调用 initiatize()。 
OQ Address, 一 个 包含 几 个 字段 的 结构 。 
























































@ 想 了 解 更 多 关于 此 API 的 信息 ,可 以 访问 http://open.mapquestapi.com/nominatim。 维基 百科 提供 了 REST 的 概述 , 你 
也 可 以 访问 https://en.wikipedia.org/wiki/Representational state_transfer。 




















(2) http://curl.haxx.se/libcurl/cplusplus/ 
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口 AddressExtractor ， 它 借助 JonCpp" 库 从 一 个 JSON? 字 符 串 中 提取 地 址 ， 并 填写 Address 
结构 。 


你 的 代码 可 能 会 是 下 面 这 样 的 : 


CurlHttp http; 
http.initialize(); 
auto jsonResponse - http.get(createGetRequestUrl(latitude, longitude)); 








AddressExtractor extractor; 
auto address - extractor.addressFrom(jsonResponse); 


return summaryDescription(address); 


试想 一 下 ， 你 要 为 这 段 代 码 编写 测试 。 然 而 这 不 太 容 易 ， 因 为 CurlHttp 类 对 外 有 依赖 ， 


是 你 所 期 望 的 。 面 对 这 个 问题 ， 许 多 开发 人 员 会 运 和 UL dM, AENAREST. 











其 实 你 可 以 做 得 更 好 , 因为 你 是 在 进行 测试 驱动 开发 ! 这 意味 着 只 在 让 失败 测试 通过 时 才 往 








系统 中 加 入 代码 。 但 是 要 怎样 写 一 个 可 以 绕 开 CurlHttp 类 的 对 外 依赖 的 测试 呢 ? 我 们 将 在 下 一 
中 学 习 这 个 解决 方案 


5. 


法 


4 “手动 打造 的 测试 替身 


如 果 想 要 使 用 测试 蔡 身 ， 那 么 就 必须 让 它 取代 CurlHttp 类 的 行为 。C++ 提 供 了 许多 不 同 的 方 
， 其 中 多 态 的 使 用 频率 最 高 。 我 们 先 来 看 一 下 CurlHttp 类 实现 的 Http 接 口 。 


c5/1/http.h 


virtual ~Http() {} 
virtual void initialize() = 
virtual std::string get(const std::string& url) const = 0; 


你 要 做 的 就 是 在 派生 类 中 禾 写 虚 函 数 , 并 在 这 个 覆 写 中 提供 特别 的 行为 来 支持 测试 , 然后 将 





























基 类 指针 传递 给 地 名 描述 服务 。 


现在 来 看 一 些 代 码 。 


c5/1/PlaceDescriptionServiceTest.cpp 


TEST F(APlaceDescriptionService, ReturnsDescriptionForValidLocation) { 
HttpStub httpStub; 


PlaceDescriptionService service[&httpStub] ; 


auto description = service.summaryDescription(ValidLatitude, ValidLongitude); 





(D http://www.json.org 
(25 http://jsoncpp.sourceforge.net 
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ASSERT THAT(description, Eq("Drury Ln, Fountain, CO, US")); 
J 


我 们 在 测试 中 创建 了 HttpStub 类 的 一 个 实例 。HttpStub 正 是 测试 替身 的 类 型 ， 它 是 一 个 派生 
自 Http 的 类 。 我 们 在 测试 文件 中 直接 定义 了 HttpStub ， 这 样 能 方便 地 看 到 它 的 行为 和 使 用 它 的 测 
试 代 码 。 






































c5/1/PlaceDescriptionServiceTest.cpp 
class HttpStub: public Http ( 
void initialize() override {} 
std::string get(const std::string& url) const override { 
return "???"; 
} 
H 


返回 带 有 一 些 问号 的 字符 串 没什么 用 处 。 那 该 从 get() 中 返回 什么 呢 ? 由 于 外 部 Nominatim 
搜索 服务 返回 的 是 一 个 JSON 响 应 ， 因 此 我 们 也 应 该 返回 一 个 JSON 咱 应 ， 可 以 从 这 个 响应 中 生成 
测试 断言 所 期 待 的 描述 。 


c5/2/PlaceDescriptionServiceTest.cpp E 


class HttpStub: public Http ( 
void initialize() override {} 
std::string get(const std::string& url) const override ( 
return R"(( "address": { 

"road" :"Drury Ln", 
"city":"Fountain", 
"state":"CO", 
"country":"US" jj)"; 























} 
}; 


我 是 怎么 想到 这 个 JSON 响 应 的 呢 ? 我 用 浏览 器 提交 了 一 份 真 实 的 GET 请 求 ( Nominatim 搜 索 
服务 API 的 文档 会 教 你 怎么 做 )， 然 后 截取 了 返回 的 结 

在 测试 中 , 我 们 将 HttpStub 实 例 传递 给 了 PlaceDescriptionService 的 构造 函数 。 和 原先 的 
预想 相 比 ， 我 们 正在 改变 设计 。 服 务 对 象 本 身 不 创建 私有 的 Http 实 例 ， 相 反 ， 使 用 该 服务 对 象 的 
客户 端 需要 自己 创建 一 个 Http 实 例 ， 并 把 它 传 给 服务 对 象 。 服 务 对 象 通过 一 个 基 类 指针 持 有 这 个 
Http 实 例 。 


c5/2/PlaceDescriptionService.cpp 
PlaceDescriptionService::PlaceDescriptionService(Http* http) : http (http) {} 


简单 的 多 态 赋予 了 我 们 所 需 的 测试 替身 的 灵活 性 。PlaceDescriptionService 对 象 不 知道 它 持 有 
的 Http 实 例 是 一 个 真正 的 实例 ， 还 是 一 个 仅仅 为 了 测试 的 实例 。 


一 旦 测试 编译 通过 并 运行 失败 ， 就 可 以 编写 summaryDescription() 了 。 
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c5/2/PlaceDescriptionService.cpp 
string PlaceDescriptionService::summaryDescription( 
const string& latitude, const string& longitude) const ( 
auto getRequestUrl - 
auto jsonResponse = http -»get(getRequestUrl); 


AddressExtractor extractor; 

auto address - extractor.addressFrom(jsonResponse); 

return address.road + ", " + address.city + ", "+ 
address.state + ", " + address.country; 


} 


(幸运 的 是 ,其 他 人 已 经 为 我 们 构建 了 AddressExtractor。 它 能 解析 JSON 响 应 , 并 填写 Address 
结构 体 。) 




















当 测 试 调用 summaryDescription() 时 ,对 get() 的 调用 实际 作用 在 HttpStub 实 例 上 。get() 
返回 的 结果 是 预先 硬 编码 的 JSON 字 符 串 。 返 回 硬 编码 值 的 测试 奉 身 叫 作 存根 (stub )。 类 似 地 ， 
我 们 也 可 以 称 get( ) 为 存根 方法 。 

我 们 测试 驱动 开发 了 summaryDescription()。 但 是 ， ee 当 正 在 接受 测试 
的 代码 和 一 个 协同 对 象 交互 时 ， 需 要 保证 给 它 传 递 一 个 正确 的 值 。 你 怎 道 传 给 Http 实 例 的 
URL 是 合法 的 呢 ? 

实际 上 , 在 上 述 的 代码 中 我 们 传 给 get( ) 一 个 空 字符 串 ( 即 getRequestUrl ), 以便 可 以 增 量 地 
FE ME, 我们 需要 编写 能 正确 给 ee a 我 们 可 以 使 用 三 角 法 ,并 为 
第 二 个 位 置 添 加 一 个 断言 ( 参考 10.4.2 节 )。 


更 好 的 做 法 是 在 HttpStub 中 的 get() 中 加 入 一 个 断言 。 

































































c5/3/PlaceDescriptionServiceTest.cpp 


class HttpStub: public Http ( 
void initialize() override 1) 
std::string get(const std::string& url) const override ( 
» verify(url); 
return R"(( "address": { 
"road":"Drury Ln", 
"city":"Fountain", 
"state":"CO", 
"country":"US" jj)"; 


void verify(const string& url) const ( 
auto expectedArgs( 
"Latz" + APlaceDescriptionService::ValidLatitude + "&" + 
"Lonz" + APlaceDescriptionService::ValidLongitude); 
ASSERT THAT(url, EndsWith(expectedArgs)); 


Hn 
(为 什么 要 为 断言 逻辑 创建 一 个 独立 的 verify() 呢 ? 这 其 实 是 Google Mock 自 身 的 一 个 限 
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制 : 你 只 能 在 返回 void 的 函数 中 使 用 会 导致 致命 错误 的 断言 "。) 

在 调用 get ( ) 时 ， 存 根 实 现 可 以 确保 参数 符合 预期 。 存 根 实 现 中 的 断言 验证 了 URL 最 重要 的 
方面 : 这 个 URL 是 否 包 含 正 确 的 纬度 和 经 度 。 目 前 来 说 ， 测 试 是 失败 的 ， 因 为 我 们 传 给 get ( ) 的 
是 一 个 空 字符 串 。 我 们 可 以 做 一 下 改动 让 测试 通过 ， 如 下 所 示 : 



























































c5/3/PlaceDescriptionService.cpp 


string PlaceDescriptionService::summaryDescription( 
const string& latitude, const string& longitude) const { 
» auto getRequestUrl = "lat=" + latitude + "&lon-z" + longitude; 
auto jsonResponse = http -»get(getRequestUrl); 


Z4 x 
) 
由 于 当前 的 URL 没 有 指定 一 个 服务 需 或 文档 ， 因 此 它 还 不 能 很 好 地 工作 。 我 们 可 以 增强 
verify() Kit, IEEE get () 一 个 完整 的 URL。 


c5/4/PlaceDescriptionServiceTest.cpp 


void verify(const string& url) const { 
string urlStart( 


"http://open.mapquestapi.com/nominatim/v1/reverse?format-json&"); 
string expected(urlStart + 

"lat=" + APlaceDescriptionService::ValidLatitude + "&" + 

"Lonz" + APlaceDescriptionService::ValidLongitude); 
» ASSERT THAT(url, Eq(expected)); 
} 


一 旦 测试 通过 了 ， 就 要 做 一 些 重 构 。summaryDescription() 方 法 缺乏 整体 感 ， 测 试 和 产品 
代码 中 构造 “ 键 - 值 ”对 的 代码 是 重复 的 。 修 改 后 的 代码 如 下 : 





vyy 





c5/4/PlaceDescriptionService.cpp 


string PlaceDescriptionService::summaryDescription( 
const string& latitude, const string& longitude) const { 
auto request - createGetRequestUrl(latitude, longitude); 
auto response - get(request); 
return summaryDescription(response); 
} 
string PlaceDescriptionService: :summaryDescription( 
const string& response) const { 
AddressExtractor extractor; 
auto address - extractor.addressFrom(response); 
return address.summaryDescription(); 


} 


string PlaceDescriptionService::get(const string requestUrl) const { 
return http_->get(requestUrl); 
} 





(D http://code.google.com/p/googletest/wiki/AdvancedGuide#Assertion Placement 
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string PlaceDescriptionService::createGetRequestUrl( 
const string& latitude, const string& longitude) const { 
string server("http://open.mapquestapi.com/"); 
string document("nominatim/vl/reverse"); 
return server + document + "?" + 
keyValue("format", "json") + "&" + 
keyValue("lat", latitude) + "&" + 
keyValue("lon", longitude); 
} 


string PlaceDescriptionService: :keyValue( 
const string& key, const string& value) const { 
return key + "=" + value; 


} 

那 又 该 如 何 处 理 其 《他 的 重复 代码 呢 ? (你 会 问 :“ 还 有 哪些 重复 代码 ? ”) 测试 中 的 文本 和 产 
品 代码 中 的 文本 完全 一 样 。 应 该 消除 这 一 重复 吗 ? 我 们 可 以 采取 多 种 方法 ( 参见 7.4.6 节 )。 

如 果 就 此 停止 的 话 ， 目 前 的 代码 设计 似乎 也 足够 了 。 我 们 引入 了 一 些 可 读 性 较 高 的 函数 。 我 
们 也 需要 做 出 一 些 改 动 。 貌 似 可 以 重用 keyValue( ) 函数 了 。 我 们 也 能 看 出 ， 可 以 迅速 一 般 化 现 
在 的 设计 来 支持 第 二 个 服务 ， 因 为 PlaceDescriptionService 中 的 一 些 结构 是 可 以 复 用 的 。 


但 是 ,测试 的 设计 还 稍 显 不足 。 对 于 未 参与 代码 编写 的 程序 员 来 说 ,实在 难以 跟 上 。 继 续 阅 
读 吧 ! 









































5.5 在 使 用 测试 替身 时 提升 测试 的 抽象 程度 
我 们 很 容易 创建 难以 阅读 的 测试 ,尤其 是 使 用 测试 蔡 身 时 ， 因 为 测试 中 模 楼 两 可 的 信息 增加 
了 理解 的 难度 。 


因为 ReturnDescriptionForValidLocation 隐 藏 了 相关 的 信息 ， 所 以 理解 起 来 比较 困难 。 这 和 测 
试 抽象 理念 相 冲突 (参见 7.4 节 )。 




















c5/4/PlaceDescriptionServiceTest.cpp 


TEST F(APlaceDescriptionService, ReturnsDescriptionForValidLocation) { 
HttpStub httpStub; 
PlaceDescriptionService service[&httpStub) ; 


auto description = service.summaryDescription(ValidLatitude, ValidLongitude); 


ASSERT THAT(description, Eq("Drury Ln, Fountain, CO, US")); 
F 


为 什么 获取 的 描述 是 一 个 在 Colorado 的 Fountain 城 的 地 名 呢 ? 阅读 测试 的 人 必须 要 查看 
HttpStub 实 现 中 与 此 地 址 相关 的 JSON 信 息 。 


我 们 必须 要 重 构 测 试 ， 使 它 可 以 自 包含 。 可 以 修改 HttpStub 的 实现 ， 让 测试 负责 设 定 get () 
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方法 的 返回 值 。 


c5/5/PlaceDescriptionServiceTest.cpp 


class HttpStub: public Http ( 
» public: 
» string returnResponse; 
void initialize() override 1) 
std::string get(const std::string& url) const override ( 
verify(url); 
» return returnResponse; 


) 


void verify(const string& url) const { 
/h. 
} 
}; 


TEST F(APlaceDescriptionService, ReturnsDescriptionForValidLocation) { 
HttpStub httpStub; 





» httpStub.returnResponse = R"(("address": { 

» "road":"Drury Ln", 

» "city":"Fountain", 

» "state":"CO", 

» "country":"US" Jj)"; 
PlaceDescriptionService service([&httpStub) ; 
auto description = service.summaryDescription(ValidLatitude, ValidLongitude); 
ASSERT THAT(description, Eq("Drury Ln, Fountain, CO, US")); 

} 


现在 ， 阅 读 测试 的 人 可 以 将 摘要 描述 和 HttpStub 返 回 的 JSON 对 象 联系 起 来 了 。 
类 似 地 ， 我 们 也 可 以 将 URL 验 证 移 到 测试 中 。 


c5/6/PlaceDescriptionServiceTest.cpp 


class HttpStub: public Http { 
public: 
string returnResponse; 
> string expectedURL; 
void initialize() override {} 
std::string get(const std::string& url) const override ( 
verify(url); 
return returnResponse; 


} 

void verify(const string& url) const { 
» ASSERT THAT(url, Eq(expectedURL)) ; 

} 


}; 


TEST F(APlaceDescriptionService, ReturnsDescriptionForValidLocation) { 
HttpStub httpStub; 
httpStub.returnResponse = // ... 
» string urlStart( 
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"http://open.mapquestapi.com/nominatim/vi/reverse?format=json&"}; 
httpStub.expectedURL = urlStart + 

"lat=" + APlaceDescriptionService::ValidLatitude + "&" + 

"lon=" + APlaceDescriptionService::ValidLongitude; 
PlaceDescriptionService service{&httpStub}; 


Yyyy 


auto description = service.summaryDescription(ValidLatitude, ValidLongitude); 


ASSERT_THAT (description, Eq("Drury Ln, Fountain, CO, US")); 
} 


现在 , 测试 变 长 了 , 但 是 能 清晰 地 表达 其 意图 。 相 比 之 下 , 我 们 将 HttpStub 削 减 至 一 个 小 类 ， 
它 符合 期 望 并 返回 所 需 的 信息 。 由 于 它 同时 也 验证 了 期 望 的 信息 ， 因 此 HttpStub 从 一 个 存根 演化 
为 了 一 个 模拟 对 象 ( mock )。 一 个 模拟 对 象 是 一 个 测试 替身 ， 它 符合 期 望 并 且 能 够 自我 验证 所 期 
望 的 信息 "。 在 我 们 的 例子 中 ， 一 个 HttpStub 对 象 验证 了 这 样 的 事实 : 会 有 一 个 期 望 的 URL 传 给 
HttpStub。 


要 测试 驱动 开发 一 个 对 诸如 数据 库 和 外 部 服务 调用 有 依赖 的 系统 , 你 需要 多 个 模拟 对 象 。 如 
果 这 些 对 象 仅仅 是 完成 期 望 的 任务 ,并 返回 期 望 的 值 , 那 它们 长 得 都 差不多 。 模 拟 对 象 工具 可 以 
帮助 减轻 定义 测试 蔡 身 的 工作 量 。 


















































5.6 ”使 用 模拟 对 象 工具 


模拟 对 象 工具 ， 如 Google Mock、CppUMock 或 者 Hippp Mocks ， 都 能 减轻 定义 模拟 对 象 和 设 
定期 望 的 工作 。 你 将 在 本 节 中 学 习 如 何 使 用 Google Mock。 


5.6.1 定义 一 个 派生 类 
现在 我 们 来 重新 测试 驱动 开发 summaryDescription()。 我 们 需要 模拟 HTTP 方 法 : get() 


和 initiaLize()。 


c5/7/Http.h 


virtual -Http() {} 
virtual void initialize() = 0; 
virtual std::string get(const std::string& url) const - 0; 


为 了 使 用 Google Mock 自 身 的 模拟 对 象 ， 我 们 首先 需要 创建 一 个 派生 类 用 来 声明 所 模拟 的 方 
法 。Google Mock 允 许 我 们 简洁 地 定义 名 为 HttpStub 的 派生 类 。 








c5/7/PlaceDescriptionServiceTest.cpp 


class HttpStub: public Http ( 
public: 
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» MOCK METHODO(initialize, void()); 
» MOCK CONST METHOD1(get, string(const string&)); 
}; 
你 可 以 使 用 一 些 宏 来 声明 模拟 的 方法 。MOCK_CONST_METHOD1 告 诉 Google Mock 定 义 一 个 带 
有 一 个 参数 的 const 成 员 函 数 ( MOCK_CONST_METHOD1 示 尾 的 1 就 是 指 一 个 参数 )。 宏 的 第 一 个 参 
数 ， 即 get()， 是 成 员 函 数 的 名 称 。 你 还 要 提供 成 员 函 数 签 明 的 其 他 部 分 ( 返回 值 和 参数 声明 )， 
即 第 二 个 宏 参 数 给 出 的 string(const string&)。 


为 了 模拟 initialize() ,你 可 以 使 用 MOCK_METH0D0 , 它 创建 了 非 const 且 无 参数 的 函数 声明 。 
宏 的 第 二 个 参数 即 void() ， 告 诉 Google Mock 去 声明 一 个 不 带 参数 且 返 回 值 为 void 的 函数 。 

Google Mock 还 提供 了 模拟 模板 函数 的 支持 ， 此 外 还 可 以 指定 调用 约定 "。 

Google Mock 把 一 个 mock 声 明 转 为 派生 类 中 的 一 个 成 员 函 数 。Google Mock 还 在 幕后 实现 了 
这 个 函数 。 如 果 成 员 函 数 没 有 和 覆 写 基 类 成 员 函 数 ， 那 么 你 就 不 会 得 到 所 需 的 行为 。 


《在 C++11 里 ，override 关 键 字 可 以 让 编译 器 来 验证 是 否 正 确 地 覆 写 了 一 个 函数 。 但 是 ， 
MOCK_METH0D 宏 还 没有 使 用 override 关 键 字 。 访 问 https:/code.google.comy/p/googlemockissues/ 
detail?id=157 来 获取 一 个 补丁 ， 它 可 以 修复 Google Mock 的 这 个 问题 。) 

































































5.6.2 ”设立 期 望 


我 们 决定 删 掉 summaryDescription() 的 实现 ， 然 后 重头 测试 驱动 开发 一 次 。 这 次 ， 先 缩小 
第 一 个 测试 的 范围 。 我 们 先 不 去 完全 实现 summaryDescription() ， 而 是 仅仅 发 送 一 个 HITP 请 
求 。 我 们 使 用 一 个 新 的 测试 名 称 来 表达 意图 。 

















c5/7/PlaceDescriptionServiceTest.cpp 


TEST F(APlaceDescriptionService, MakesHttpRequestToObtainAddress) ( 

HttpStub httpStub; 

string urlStart( 
"http://open.mapquestapi.com/nominatim/v1/reverse?format-json&"); 

auto expectedURL = urlStart + 
"lat=" + APlaceDescriptionService::ValidLatitude + "&" + 
"Lonz" + APlaceDescriptionService::ValidLongitude; 

» EXPECT CALL(httpStub, get(expectedURL)); 
PlaceDescriptionService service([&httpStub) ; 


service.summaryDescription(ValidLatitude, ValidLongitude); 


} 


在 这 个 测试 中 我 们 使 用 EXPECT_CALL 安 设立 期 望 ， 让 它 作为 测试 Arrange (参见 4.2.4 节 ) 步 
又 的 一 部 分 。 这 个 宏 配 置 Google Mock 去 验证 给 定 一 个 参数 去 调用 httpStub 对 象 的 get ( ) 得 到 的 














(D http://code.google.com/p/googlemock/wiki/V1 6 CheatSheetDefining a Mock Class 
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返回 值 是 否 与 expectedURL 吻 合 。 


么 断言 在 哪 呢 ?Google Mock 会 在 模拟 对 象 跳出 作用 域 后 才 es pu 我 们 的 测 
试 并 没有 遵循 AAA ( Arrange-Act-Assert )， 但 是 断言 步 又 仍然 执行 了 ， 只 不 过 是 隐 式 地 完成 了 。 
一 些 模拟 工具 需要 显 式 地 添加 验证 调用 ， 这 让 上 断言 步骤 变 


如 果 需 要 ， 也 可 以 强制 Google Mock 在 模拟 对 象 跳出 作用 域 前 做 验证 。 


Mock: :VerifyAndClearExpectations(&httpStub); 


虽然 有 些 人 喜欢 加 个 显 式 的 断言 部 分 , 但 这 不 是 必需 的 。 你 很 快 就 会 学 会 在 设置 模拟 对 象 期 
望 时 如 何 去 阅 读 测试 。 


我 们 只 实现 部 分 summaryDescription()， 让 测试 编译 通过 就 可 以 。 














c5/7/PlaceDescriptionService.cpp 


string PlaceDescriptionService::summaryDescription( 
const string& latitude, const string& longitude) const ( 
return ""; 


p 
运行 一 下 测试 就 会 得 到 如 下 的 失败 信息 : 


Actual function call count doesn't match EXPECT CALL(httpStub, get(expectedURL))... 
Expected: to be called once 
Actual: never called - unsatisfied and active 


期 望 没有 满足 。 直 到 测试 结束 为 止 , httpStub 对 象 的 get ( ) 也 没有 被 调用 。 没 能 通过 是 好 事 ! 
我 们 可 以 实现 只 够 让 测试 通过 的 代码 。 





























c5/8/PlaceDescriptionService.cpp 


string PlaceDescriptionService::summaryDescription( 
const string& latitude, const string& longitude) const ( 

string server("http://open.mapquestapi.com/"); 

string document("nominatim/vl/reverse"); 

string url = server + document + "?" + 
keyValue("format", "json") + "&" + 
keyValue("lat", latitude) + "&" + 
keyValue("lon", longitude); 

http -»get(url); 

return ""; 


H 
我 们 可 以 写 第 二 个 测试 让 summaryDescription() 变 得 具体 化 。 








c5/9/PlaceDescriptionService.cpp 


TEST F(APlaceDescriptionService, FormatsRetrievedAddressIntoSummaryDescription) { 
HttpStub httpStub; 
» EXPECT CALL(httpStub, get( )) 
» .WillOnce(Return( 
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» R"(( "address": ( 
» "road":"Drury Ln", 
» "city":"Fountain", 
» "state":"CO", 
» "country":"US" 33)")); 
PlaceDescriptionService service(&httpStub); 
auto description - service.summaryDescription(ValidLatitude, ValidLongitude); 
ASSERT THAT(description, Eq("Drury Ln, Fountain, CO, US")); 
} 
测试 中 的 EXPECT - CALL ( () 调 用 会 告诉 Google Mock 在 调用 get ( ) 时 会 返回 什么 。 这 里 需要 解 
释 一 下 : 对 HttpStub 对 象 调用 get ( ) 会 一 次 (就 一 次 ) 返回 一 个 特定 的 JSON 字 符 串 。 


我 们 不 在 乎 调用 get ( ) 时 会 传递 什么 参数 ， 因 为 在 MakesHttpRequestToObtainAddress 中 已 经 
验证 了 该 行为 。 因此 在 EXPECT_CALL() 中 ， 我 们 使 用 了 通配符 〈 即 一 个 下 划 线 ， 全 称 为 








testing:: ) 作为 get() 的 参数 。 这 个 通配符 可 以 让 Google Mock 匹 配 出 所 有 对 此 函数 的 调用 ， 








不 管 参数 是 什么 。 























使 用 通配符 可 以 剥离 不 相干 的 细节 ,这 提升 了 测试 的 抽象 程度 。 但 是 ,不 考虑 URL 人 参数 意味 








着 我 们 最 好 有 其 他 测试 (MakesHttpRequestToObtainAddress 测 试 ) 来 验证 传人 参数 的 合理 


th 














E。 换 


句 话 说， 除非 你 的 确 不 用 考虑 参数 ， 或 已 经 有 了 一 个 验证 参数 的 测试 ， 和 否则 ， 不 要 使 用 通配符 。 
(通配符 是 Google Mock 提 供 的 众多 匹配 器 中 的 一 种 。 这些 匹 配器 就 是 前 面 测试 断言 中 所 使 用 





的 。 参 考 Google Mock 3c P oues SE) 
让 我 们 编写 代码 让 测试 通过 。 


c5/9/PlaceDescriptionService.cpp 


string PlaceDescriptionService::summaryDescription( 
const string& latitude, const string& longitude) const { 

string server("http://open.mapquestapi.com/"); 

string document("nominatim/vl/reverse"); 

string url = server + document + "?" + 
keyValue("format", "json") + "&" + 
keyValue("lat", latitude) + "&" + 
keyValue("lon", longitude); 

» auto response - http -»get(url); 


AddressExtractor extractor; 
auto address - extractor.addressFrom(response); 
return address.summaryDescription(); 


} 


vyy 


可 以 通过 重 构 , 让 现 有 的 实现 与 使 用 手工 模拟 对 象 情形 得 到 的 实现 保持 一 致 ( 参见 code/ c5/10 


中 的 源 代码 )。 





(D http://code.google.com/p/googlemock/wiki/V1 6 CheatSheet#Matchers 
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5.6.3” 松 模拟 和 严 模拟 


细心 的 读者 可 能 注意 到 了 ， 我 们 在 summaryDescription() 的 实现 中 并 没有 遵循 CurlHttp 接 
口 。 而 且 在 调用 get ( ) 前 并 没有 调用 initiatLize()。( 不 要 忘记 运行 集成 测试 哦 ! ) 我 们 可 以 在 
MakesHttpRequestToObtainAddress 测 试 中 加 入 一 个 要 求 ， 确 保 initiatLize() 被 调用 。 








c5/11/PlaceDescriptionServiceTest.cpp 


TEST F(APlaceDescriptionService, MakesHttpRequestToObtainAddress) 1 

HttpStub httpStub; 

string urlStart( 
"http://open.mapquestapi.com/nominatim/vl/reverse?format-json&"); 

auto expectedURL = urlStart + 
"lat=" + APlaceDescriptionService::ValidLatitude + "&" + 
"lon=" + APlaceDescriptionService::ValidLongitude; 

> EXPECT CALL(httpStub, initialize()); 
EXPECT CALL(httpStub, get(expectedURL)); 
PlaceDescriptionService service[&httpStub] ; 


service.summaryDescription(ValidLatitude, ValidLongitude); 


) 
我 们 保持 summaryDescription() 中 的 总 体 策略 不 变 , 单独 改动 Fget () 来 更 新 它 的 实现 细节 。 


c5/11/PlaceDescriptionService.cpp 


string PlaceDescriptionService::get(const string& url) const ( 
> http ->initialize(); 
return http -»get(url); 
j 


运行 一 下 测试 ， 我 们 会 得 到 一 个 警告 信息 ， 不 是 来 自 于 MakesHttpRequestToObtainAddress , 
而 是 另外 一 个 测试 FormatsRetrievedAddressIntoSummaryDescription 。 











GMOCK WARNING: 
Uninteresting mock function call - returning directly. 
function call: initialize() 


除了 那些 要 求 的 交互 ，Google Mock 还 会 捕捉 所 有 与 模拟 对 象 的 交互 。 这 个 警告 意 在 帮助 你 
了 解 没有 预期 的 交互 。 

你 的 目标 应 该 是 零 警告 , 或 者 将 它们 关闭 , 或 者 修复 它们 。 放 任 警 告 信息 不 管 将 会 产生 更 多 
的 警告 信息 。 这 时 ， 它 们 大 多 数 都 是 无 用 的 。 忽 略 Google Mock 产 生 的 警告 信息 是 不 明智 的 ， 我 
们 必须 消除 这 些 信 息 。 

我 们 也 有 其 他 的 选择 ， 例 如 向 FormatsRetrievedAddressIntoSummaryDescription 中 加 入 一 个 
期 望 ， 但 是 这 会 向 测试 引入 与 测试 目标 无 关 的 东西 。 我 们 要 尽量 避免 与 测试 抽象 理念 相悖 的 解 
决 方案 

每 当 遇 到 这 种 问题 时 , 都 要 质疑 一 下 现 有 的 设计 。 虽然 必须 调用 initialization, 但 可 不 可 以 换 
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到 其 他 地 方 ( 人 ? 然而 ,将 
调用 移 到 不 同 的 地 方 并 不 能 消除 警告 信息 。 

那 测 试 的 设计 呢 ?” 当 弃 用 手工 打造 的 模拟 解决 方案 转投 Google Mock 时 ， 可 以 把 一 个 测试 拆 
分 成 两 个 。 在 一 个 测试 中 表达 所 有 的 东西 ,意味 着 在 一 个 测试 中 为 三 个 重要 的 事件 CE. f 
Aget () 的 消息 、get() 的 返回 值 ) 设立 期 望 。 这 是 去 掉 警 告 信息 的 简单 方法 ， 但 是 ， 我 们 会 得 
到 一 个 杂乱 的 测试 (参见 7.3 节 来 获取 关于 这 个 选择 的 讨论 )。 现 在 ， 让 我 们 保持 独立 的 测试 。 

我 们 也 可 以 创建 一 个 fixture 辅 助 函 数 来 为 initialize() 增 加 一 个 期 望 ， 然 后 返回 一 个 
HttpStub 的 实例 。 我 们 可 以 把 这 个 函数 命名 为 createHttpStubExpectingInitialization()。 


Google Mock 提 供 了 更 简单 的 解决 方案 ( 其 他 的 模拟 工具 也 提供 了 类 似 的 解决 方案 )。 
NiceMock 模 板 告诉 Google Mock 只 追踪 与 设 定期 望 的 方法 的 交互 。 









































c5/12/PlaceDescriptionServiceTest.cpp 
TEST F(APlaceDescriptionService, FormatsRetrievedAddressIntoSummaryDescription) { 
» NiceMock«HttpStub» httpStub; 
EXPECT CALL(httpStub, get( )) 
.WillOnce(Return( 
FI ua 





} 
与 之 相反 ， 使 用 StrickMock 模 板 包 装 的 模拟 对 象 会 将 不 关心 的 调用 警告 信息 变 为 错误 信息 。 
StrictMock<HttpStub> httpStub; 


如 果 你 使 用 NiceMock, 那么 就 需要 承担 一 定 的 风险 。 如 果 以 后 的 代码 调用 Http 接 口 的 另 一 个 
方法 ,那么 我 们 的 测试 将 对 此 一 无 所 知 。 不 用 习惯 性 地 使 用 NiceMock， 在 需要 的 时 候 使 用 即 可 。 
如 果 需 要 经 常 使 用 的 话 ， 那 么 还 是 从 设计 上 修正 吧 ! 


可 以 参考 Google Mock 的 文档 来 了 解 更 多 关于 NiceMock 和 StrickMock 的 信息 ”。 














5.6.4 ”模拟 对 象 中 的 顺序 


虽然 不 太 可 能 , 但 是 如 果 不 小 心 将 对 Http 接 口 的 initiatize() 和 get() 函数 调用 颠倒 了 , 该 
怎么 办 呢 ? 




















c5/13/PlaceDescriptionService.cpp 

string PlaceDescriptionService::get(const string& url) const ( 
» auto response - http -»get(url); 
» http -»initialize(); 
» return response; 


F 





(D http://code.google.com/p/googlemock/wiki/CookBook#Nice Mocks and Strict Mocks 
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令 人 惊奇 的 是 ， 测 试 也 通过 了 ! 默认 情形 下 ，Google Mock 不 会 验证 满足 期 望 的 顺序 。 如 
果 你 在 意 顺序 ， 可 以 让 Google Mock ( 其 他 许多 C++ 模拟 工具 也 可 以 ) 去 验证 。 最 简单 的 方式 
是 在 测试 的 开始 定义 一 个 InSequence 实 例 , 然后 确保 接 下 来 的 EXPECT_CALLS 按 照 期 望 的 顺序 
出 现 。 











c5/13/PlaceDescriptionServiceTest.cpp 
TEST F(APlaceDescriptionService, MakesHttpRequestToObtainAddress) 1 
» InSequence forceExpectationOrder; 
HttpStub httpStub; 


string urlStart( 
"http://open.mapquestapi.com/nominatim/vl/reverse?format-json&"); 


auto expectedURL = urlStart + 
"lat=" + APlaceDescriptionService::ValidLatitude + "&" + 
"lon=" + APlaceDescriptionService::ValidLongitude; 
EXPECT CALL(httpStub, initialize()); 
EXPECT CALL(httpStub, get(expectedURL)); 
PlaceDescriptionService service[&httpStub) ; 


service.summaryDescription(ValidLatitude, ValidLongitude); 


} 

如 果 你 需要 的 话 ，Google Mock 还 提供 了 更 精细 的 顺序 控制 。After( ) 表 明 一 个 期 望 必须 在 
另 一 个 期 望 之 后 执行 ， 这 个 期 望 才 满足 。Google Mock 还 容许 你 定义 一 个 期 望 调用 的 顺序 列表 。 
可 以 参考 Google Mock 文 档 获 取 更 多 信息 "。 





5.6.5 巧妙 的 模拟 工具 特性 


EXPECT_CALL 宏 支持 许多 修饰 符 。 它 的 语法 是 : 


EXPECT CALL(mock object, method(matchers)) 
.With(multi argument matcher) ? 
.Times (cardinality) 
.InSequence(sequences) 
.After(expectations) 
.WillOnce(action) 
.WillRepeatedly(action) 
.RetiresOnSaturation(); 


(? 和 * 代 表 每 个 修饰 符 的 基数 : ?表示 可 以 选用 修饰 符 一 次 ; * 表 示 可 以 多 次 使 用 修饰 符 。) 


最 有 用 的 修饰 符 是 Times() ， 它 可 以 让 你 指定 一 个 方法 被 调用 的 次 数 。 即 使 你 知道 一 个 方法 
会 被 调用 多 次 , 但 不 知道 具体 多 少 次 , 那么 你 也 可 以 使 用 WiLLRepeatedtLy ( ) 。 参 考 Google Mock 





Po 














(D http://code.google.com/p/googlemock/wiki/CheatSheet#Expectation Order 
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文档 获取 更 多 信息 "。 


Google Mock 是 一 个 通用 的 单元 测试 工具 ， 它 支持 几乎 所 有 的 模拟 方式 。 例 如 ， 你 可 以 使 用 
Google Mock 模 拟 出 一 个 具有 输出 参数 的 函数 。 下面 示 例 中 的 接口 是 在 DifficultCollaborator 
类 中 定义 的 ， 它 既 能 返回 一 个 值 ， 也 能 输出 值 到 参数 。 























c5/13/OutParameterTest.cpp 


virtual bool calculate(int* result); 

你 可 以 使 用 WiLLOnce() 或 WiLLRepeatedtLy () XGoogle Mock 期 望 指定 一 个 动作 。 大 部 分 时 
候 ， 这 个 动作 是 返回 一 个 值 。 当 一 个 函数 不 止 需要 返回 一 个 值 时 ， 你 就 可 以 使 用 能 将 两 个 或 多 个 
动作 组 合 起 来 的 DoALL( ) 。 








c5/13/OutParameterTest.cpp 
DifficultCollaboratorMock difficult; 
Target calc; 

EXPECT CALL(difficult, calculate( )) 


» .WillOnce(DoAll( 
» SetArgPointee«0»(3), 
» Return(true))); 





auto result = calc.execute(&difficult); 

ASSERT THAT(result, Eq(3)); 

这 个 测试 中 的 另 一 个 动作 是 SetArgPointee<0>(3) ， 它 告诉 Google Mock 去 设置 被 指 者 ( BI 
指针 所 指 的 ) 的 第 0 个 参数 的 值 为 3。 

Google Mock 为 其 他 的 动作 提供 了 强 有 力 的 支持 ， 包 括 抛 出 异常 、 设 置 变量 、 删 除 参 数 、 调 
用 函数 或 函数 对 象 。 可 以 参考 Google Mock 的 文档 获取 完整 列表 ?。 

并 不 是 因为 可 以 使 用 这 些 特 性 就 必须 要 用 它们 。 大 部 分 情况 下 使 用 之 前 学 习 到 的 Google 
Mock 提 供 的 基本 机 制 就 足够 了 。 在 测试 驱动 开发 时 ， 如 果 你 经 常 要 去 使 用 怪异 的 模拟 工具 特性 ， 
那么 请 停 下 来 检查 一 下 你 的 设计 。 你 所 测 的 方法 是 不 是 做 了 过 多 的 事情 ? 为 了 使 其 不 需要 过 度 复 
杂 的 模拟 ， 可 以 重新 以 男 一 种 方式 调整 下 设计 吗 ?” 大 多 数 情况 下 你 是 可 以 做 到 的 。 

当 你 尝试 着 为 非 测试 驱动 的 、 结 构 不 良 的 系统 编写 测试 并 遇 到 问题 时 ,或 许 需要 使 用 模拟 工 
有 具 提供 的 更 加 强大 的 特性 。 我 们 会 在 第 8 章 中 讨论 这 类 问题 。 

























































































(D http://code.google.com/p/googlemock/wiki/CheatSheet#Setting Expectations,http://code.google.com/p/googlemock/wiki/For 
DummiesZSetting Expectations 
(25 http://code.google.com/p/googlemock/wiki/CheatSheet£'Actions 
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5.6.6 ”排除 模拟 失败 
你 将 会 为 正确 地 定义 模拟 对 象 而 努力 。 说 实在 的 : 当 我 在 为 本 书 编写 当前 示例 时 ， 遇 到 了 下 
面 的 错误 信息 ， 还 真有 点 儿 把 我 难 住 了 。 


Actual function call count doesn't match EXPECT CALL(httpStub, get(expectedURL))... 
Expected: to be called once 
Actual: never called - unsatisfied and active 


第 一 件 需要 确定 的 事情 是 , 在 产品 代码 中 是 否 有 合理 的 调用 。( 你 有 没有 编写 相应 的 代码 ? ) 
第 二 件 需 要 确定 的 事情 是 , 你 是 否 正确 定义 了 模拟 方法 ?如 果 不 是 很 确定 , 那么 可 以 在 产品 代码 
实现 的 第 一 行 加 一 个 cout 语 句 ， 或 者 借助 调试 器 来 查 明 原 因 。 


你 有 没有 把 要 模拟 的 成 员 函 数 声明 为 虚 函 数 ? 


你 是 不 是 把 MOCK_METHOD( ) 声 明 弄 错 了 ? 在 这 里 , 所 有 的 类 型 信息 必须 精确 匹配 , 否则, 模 
拟 的 方法 将 不 会 被 覆 写 。 同 时 你 也 要 保证 所 有 的 const 声 明 是 一 样 的 。 


如 果 还 是 不 行 ， 那 么 就 先 排除 关于 参数 匹配 的 担忧 。 为 所 有 的 参数 和 返回 值 使 用 通配符 
(testing:: )。 如 果 测 试 通过 ， 那么 肯定 有 一 个 参数 不 能 被 Google Mock 视 为 匹配 。 


我 就 犯 过 一 个 愚蠢 的 错误 : 不 小 心 把 const 声 明 从 URL 参 数 前 移 除 了 。 



















































































5.6.7 一 个 还 是 两 个 测试 


当 使 用 手工 创建 的 模拟 对 象 时 , 我 们 最 终 只 用 了 一 个 测试 来 验证 最 终 的 目标 ， 即 为 一 个 位 置 
生成 概要 信息 描述 。 但 是 ， 在 第 二 个 示例 中 ,我们 却 用 了 两 个 测试 。 哪 个 对 呢 ? 


从 文档 化 公有 行为 ( 即 客户 所 关心 的 行为 ) 的 角度 来 说 ，PlaceDescriptionService 的 唯一 目标 
就 是 对 给 定 的 位 置 返 回 包含 概 要 信息 的 字符 串 。 对 于 测试 阅读 者 来 说 , 在 测试 中 来 描述 这 个 行为 
更 简单 。 客 户 并 不 关心 summaryDescription() 和 Http 协 同 对 象 是 怎样 交互 的 。 这 是 一 个 实现 细 
节 〈 你 或 许 会 想到 一 个 解决 方案 ， 这 个 方案 中 所 有 的 地 理 信息 都 在 本 地 )。 创 建 第 二 个 测试 来 曾 
明 这 个 交互 有 意义 吗 ? 

当然 有 意义 ! TDD 最 重要 的 价值 就 在 于 帮助 你 开发 和 塑造 系统 的 设计 。 与 协同 对 象 的 交互 是 
设计 的 关键 。 用 测试 来 描述 那些 交互 对 于 其 他 开发 者 来 说 很 有 价值 。 
拥有 两 个 测试 还 会 提供 额外 的 好 处 。 第 一 ,一 个 模拟 验证 是 一 个 断言 。 我 们 已 经 用 一 个 断言 
来 验证 概要 信息 字符 串 了 。 将 测试 分 为 两 个 , 与 一 个 断言 一 个 测试 保持 一 致 (参考 7.3 节 ), 第 二 ， 
独立 的 测试 更 具 可 读 性 。 由 于 在 Google Mock 中 设立 期 望 会 导致 很 难 界定 设置 断言 的 位 置 (这 也 
和 4.2.4 节 一 致 )， 因 此 我 们 为 简化 基于 模拟 的 测试 的 努力 是 值得 的 。 
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57 ”让 测试 替身 各 就 各 位 
在 引入 一 个 测试 替身 时 需要 做 两 件 事 。 第 一 ， 编 写 测试 蔡 身 。 第 二 , 在 目标 测试 中 使 用 测试 
替身 的 一 个 实例 。 这 样 的 做 法 又 称 作 依赖 注入 (Dependency Injection, DI )。 


以 PlaceDescriptionService 为 例 ， 通 过 一 个 构造 函数 ,我 们 将 测试 替身 注 和 其中。 在 一 些 情况 
下 ， 你 会 发 现 通过 一 个 setter 成 员 函 数 来 注入 测试 替身 更 合适 。 这 种 方法 又 称 作 构造 函数 注入 或 


Setter 注 入 。 


也 有 很 多 其 他 让 测试 蔡 身 各 就 各 位 的 方法 ,你 可 以 根据 自己 的 需求 选用 最 适合 的 一 种 。 











5.7.1 覆 写 工厂 方法 和 和 窗 写 Getter 


为 了 使 用 履 写 工厂 方法 "， 必 须 修改 产品 代码 ， 使 其 在 任何 需要 一 个 协作 类 实例 时 都 可 使 用 
工厂 方法 来 获得 。 下 面 是 在 PlaceDescriptorService 中 达到 此 目的 的 一 种 改 法 : 








c5/15/PlaceDescriptionService.h 





#include «memory» 
T^ as 
virtual -PlaceDescriptionService() () 
I7 x 
protected: 
virtual std::shared ptr«Http» httpService() const; 


c5/15/PlaceDescriptionService.cpp 

#include "CurlHttp.h" 

string PlaceDescriptionService::get(const string& url) const ( 
» auto http = httpService(); 
» http-»initialize(); 
» return http-»get(url); 

} 


» shared_ptr<Http> PlaceDescriptionService::httpService() const { 
» return make shared«CurlHttp»(); 
>} 
相 比 于 直接 引用 成 员 变量 http_ 来 实现 与 HTTP 服 务 的 交互 ， 现 在 的 代码 调用 一 个 保护 成 员 
函数 httpService() 来 获取 一 个 Http 指 针 ?。 


在 测试 中 , 我 们 定义 了 PlaceDescriptionService 的 派生 类 。 这 个 派生 类 的 主要 工作 就 是 覆 写 返 
回 一 个 Http 实 例 的 工厂 方法 (httpService() ). 





























(D 工厂 方法 为 设计 模式 中 创建 模式 的 一 种 ， 可 以 参考 《设计 模式 》 一 书 。 一 — 译 者 注 
Q 这 里 的 指针 是 一 个 共享 指针 ， 是 一 种 智能 指针 。 一 至 者 注 
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c5/15/PlaceDescriptionServiceTest.cpp 


class PlaceDescriptionService StubHttpService: public PlaceDescriptionService ( 
public: 
PlaceDescriptionService StubHttpService(shared ptr«HttpStub» httpStub) 
: httpStub (httpStub) {} 
shared ptr«Http» httpService() const override ( return httpStub ; j 
shared ptr«Http» httpStub ; 
H 


我 们 修改 了 测试 来 创建 一 个 HttpStub 的 共享 指针 ， 并 把 它 存 在 PLaceDescriptionService 
StubHttpService 的 实例 中 。 下 面 是 修改 后 的 MakesHttpRequestToObtainAddress : 




















c5/15/PlaceDescriptionServiceTest.cpp 
TEST F(APlaceDescriptionService, MakesHttpRequestToObtainAddress) 1 
InSequence forceExpectationOrder; 
» shared ptr«HttpStub» httpStub([new HttpStub}; 


string urlStart( 
"http://open.mapquestapi.com/nominatim/vl/reverse?format-json&"); 


auto expectedURL = urlStart + 
"lat=" + APlaceDescriptionService::ValidLatitude + "&" + 
"lon=" + APlaceDescriptionService::ValidLongitude; 


> EXPECT CALL(*httpStub, initialize()); 
» EXPECT CALL(*httpStub, get(expectedURL)); 
» PlaceDescriptionService StubHttpService service[httpStub]; 
service.summaryDescription(ValidLatitude, ValidLongitude); 
j 

















履 写 工厂 方法 展示 了 使 用 测试 替身 所 带 来 的 测试 覆盖 率 漏洞 。 由 于 我 们 的 测试 覆 写 了 产品 代 
码 中 httpService() 的 实现 ， 因 此 测试 并 没有 使 用 实际 产品 代码 中 的 这 个 函数 。 正 如 前 面 所 说 ， 
要 确保 在 集成 测试 中 使 用 实际 的 服务 ! 同时 ,不 要 在 工厂 方法 中 加 入 实际 逻辑 的 代码 ,否则 ,未 
经 测试 的 代码 就 会 越 来 越 多 。 工 三 方法 应 当 只 返回 协作 类 型 的 一 个 实例 。 

除了 覆 写 工厂 方法 外 ， 还 可 以 使 用 覆 写 Getter 方 法 。 对 我 们 的 例子 来 说 主要 的 不 同 点 在 于 
httpSever() 是 一 个 简单 的 getter, 它 只 是 返回 一 个 指向 已 有 的 Http 实 例 的 成 员 变 量 。 而 在 覆 写 工 
三 方法 的 实例 中 ，httpServer() 负 责 创建 一 个 Http 的 实例 。 使 用 这 种 方法 ,测试 保持 不 变 。 















































c5/16/PlaceDescriptionService.h 


class PlaceDescriptionService { 
public: 
> PlaceDescriptionService(); 
virtual -PlaceDescriptionService() {} 
std::string summaryDescription( 
const std::string& latitude, const std::string& longitude) const; 


private: 
I v5 
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> std::shared ptr<Http> http ; 


protected: 
virtual std::shared ptr«Http» httpService() const; 
}; 


c5/16/PlaceDescriptionService.cpp 
PlaceDescriptionService: :PlaceDescriptionService() 
: http (make shared«CurlHttp»()) {} 
74. as 
shared ptr«Http» PlaceDescriptionService::httpService() const { 
» return http ; 
} 


使 用 得 当 的 话 ， 履 写 工厂 方法 和 履 写 Getter 会 简单 有 效 ， 特 别 是 在 应 对 遗留 代码 时 ( 参见 第 8 
章 )。 但 是 ， 最 好 还 是 使 用 构造 函数 注 人 和 setter 注 入 。 








5.7.2 ”使 用 工厂 


工厂 类 是 用 来 负责 创建 和 返回 实例 的 。 如 果 你 有 一 个 HttpFactory， 那 么 就 可 以 在 测试 中 告诉 
它 返 回 一 个 HttpStub 实 例 而 非 Http 实 例 。 如 果 使 用 工厂 不 合理 的 话 ， 那么 就 不 要 使 用 这 个 技巧 了 。 
仅仅 为 了 支持 测试 而 引入 工厂 不 是 个 好 的 选择 。 


下 面 是 我 们 的 工厂 实现 : 





























c5/18/HttpFactory.cpp 
#include "HttpFactory.h" 
#include "CurlHttp.h" 
#include <memory> 


using namespace std; 


HttpFactory: :HttpFactory() { 
reset(); 


} 


shared_ptr<Http> HttpFactory::get() { 
return instance; 


} 


void HttpFactory::reset() { 
instance = make_shared<CurlHttp>(); 


} 


void HttpFactory::setInstance(shared_ptr<Http> newInstance) { 
instance = newInstance; 


F 


在 测试 设置 阶段 ,创建 一 个 工厂 ， 并 在 其 中 注入 HttpStub。 然 后 在 接 下 来 的 get () 中 返回 这 
个 测试 替身 。 
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c5/18/PlaceDescriptionServiceTest.cpp 


class APlaceDescriptionService: public Test ( 
public: 

static const string ValidLatitude; 

static const string ValidLongitude; 


shared ptr«HttpStub» httpStub; 
shared ptr«HttpFactory» factory; 
shared ptr«PlaceDescriptionService» service; 


virtual void SetUp() override { 
factory = make shared«HttpFactory»(); 
service = make shared«PlaceDescriptionService»(factory); 


} 


void TearDown() override { 
factory.reset(); 
httpStub.reset(); 


h 


class APlaceDescriptionService WithHttpMock: public APlaceDescriptionService { 
public: 
void SetUp() override { 
APlaceDescriptionService::SetUp(); 
httpStub = make shared«HttpStub»(); 
factory-»setInstance(httpStub); 


}; 


TEST F(APlaceDescriptionService WithHttpMock, MakesHttpRequestToObtainAddress) { 
string urlStart( 
"http://open.mapquestapi.com/nominatim/vl/reverse?format-json&") ; 
auto expectedURL = urlStart + 
"lat=" + APlaceDescriptionService::ValidLatitude + "&" + 
"lon=" + APlaceDescriptionService::ValidLongitude; 
EXPECT CALL(*httpStub, initialize()); 
EXPECT CALL(*httpStub, get(expectedURL)) ; 
service-»summaryDescription(ValidLatitude, ValidLongitude); 


) 
我 们 修改 summaryDescription() 中 的 产品 代码 ， 以 便 从 工厂 中 获取 Http 实 例 。 


c5/18/PlaceDescriptionService.cpp 


string PlaceDescriptionService::get(const string& url) const ( 
» auto http - httpFactory -»get(); 
http-»initialize(); 
return http-»get(url); 
j 


因为 我 们 是 通过 构造 函数 来 传递 工厂 实例 的 , 所 以 这 种 方法 和 构造 函数 注入 略 有 不 同 , 此 外 
现在 还 多 了 一 个 间接 层 。 
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5.7.3. ”通过 模板 参数 


有 些 注入 技术 比较 巧妙 。 你 也 可 以 选择 通过 模板 参数 注 人 , 它 不 需要 客户 程序 传递 一 个 协作 
类 的 实例 。 最 好 在 已 经 使 用 模板 的 情形 下 使 用 模板 参数 注入 。 

我 们 把 PLaceDescriptionService 声 明 为 一 个 模板 ， 它 有 一 个 类 型 名 称 ， 即 HTTP。 在 这 个 
模板 中 加 入 一 个 成 员 变量 ，http_， 其 类 型 为 HTTP。 因 为 我 们 想 让 客户 使 用 类 名 PlaceDescription 
Service， 所 以 我 们 将 模板 类 改名 为 PlaceDescriptionServiceTemplate。 在 定义 模板 之 后 ， 我 们 使 用 
typedef 来 定义 PlaceDescriptionService ， 它 将 产品 类 Http 作 为 PlaceDescriptionServiceTemplate 的 模 
板 参 数 "。 下 面 是 代码 ; 















































c5/19/PlaceDescriptionService.h 


template«typename HTTP» 
class PlaceDescriptionServiceTemplate ( 
public: 
Af rsh 
// 测试 中 的 mock 需 要 引用 
HTTP& http() { 
return http ; 





} 
private: 
FI: ira 
std::string get(const std::string& url) { 
http_.initialize(); 
return http .get(url); 
} 
pO aaa 
HTTP http ; 
}; 
class Http; 
typedef PlaceDescriptionServiceTemplate<Http> PlaceDescriptionService; 


我 们 在 测试 的 fixture 中 声明 的 服务 类 型 是 以 一 个 模拟 类 (C Bl HttpStub ) 为 模板 参数 的 Place- 


DescriptionSeriveIemplate。 





c5/19/PlaceDescriptionServiceTest.cpp 

class APlaceDescriptionService WithHttpMock: public APlaceDescriptionService { 

public: 

PlaceDescriptionServiceTemplate«HttpStub» service; 

H 

测试 不 用 为 PlaceDescriptionService 提 供 一 个 Mock 的 实例 ， 而 只 需要 提供 Mock 的 类 型 。 
PlaceDescriptionService 会 创建 这 个 类 型 的 实例 〈 作为 成 员 变 量 http_)。 因 为 Google Mock 会 验证 
和 模板 实例 的 交互 ， 所 以 需要 让 测试 访问 它 。 为 此 ， 需 要 通过 PlaceDescriptionServiceTemplate 的 





(D PlaceDescriptionService 是 PlaceDescriptionServiceTemplate 对 于 Http 的 一 个 特 化 版 本 。 译 者 注 
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访问 函数 http () 来 修改 测试 以 便 获 得 stub 的 实例 。 


c5/19/PlaceDescriptionServiceTest.cpp 
TEST F(APlaceDescriptionService WithHttpMock, MakesHttpRequestToObtainAddress) { 


string urlStart( 
"http://open.mapquestapi.com/nominatim/v1/reverse?format-json&"); 


auto expectedURL = urlStart + 
"lat=" + APlaceDescriptionService::ValidLatitude + "&" + 
"lon=" + APlaceDescriptionService::ValidLongitude; 
> EXPECT CALL(service.http(), initialize()); 
» EXPECT CALL(service.http(), get(expectedURL)); 


service.summaryDescription(ValidLatitude, ValidLongitude); 


} 


你 可 以 通过 多 种 方法 来 使 用 模板 参数 引入 Mock， 有 些 会 比 这 里 的 实现 更 加 精巧 ( 基于 模板 
重 定义 模式 ,参见 《修改 代码 的 艺术 》 一 书 )。 





5.7.4 注入 工具 


用 于 注入 协作 对 象 作为 依赖 对 象 的 工具 又 称 为 依赖 注入 工具 。 有 两 个 知名 的 C++ 例子 ， 分 别 
是 Autumn 框 架 " 和 Qt IoC 容 器 ?。Michael Feathers 对 当前 C++ 中 的 依赖 注入 框架 作出 了 评价 ; 如果 
你 想 在 C++ 中 做 依赖 注入 , 那么 就 必须 为 要 创建 的 类 强加 一 些 限 制 .…… 你 必须 使 它们 继承 自 某 个 
其 他 类 ， 使 用 macro preregistraion 或 metaobject 库 ”。 首 先 ， 你 需要 掌握 这 里 描述 的 手工 注入 技巧 。 
其 次 , 再 去 调研 一 下 注入 工具 ,来 检查 它们 能 否 带 来 一 些 改善 。 依 赖 注 入 工具 通常 在 完全 支持 反 
射 机 制 的 语言 中 更 加 有 效 。 















































5.8 设计 会 变化 


或 许 你 对 使 用 测试 蔡 身 的 第 一 反应 是 , 它 会 改变 你 的 设计 方法 。 这 样 可 能 会 令 你 不 安 。 但 是 
不 要 担心 ， 这 是 正常 的 反应 。 
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类 。 当 然 ， 发 送 HTTP 的 请 求 也 不 是 非常 复杂 。 也 许 将 此 逻辑 放 在 一 个 小 而 独立 的 Http 类 中 是 不 





























(D http://code.google.com/p/autumnframework 
(25 http://sourceforge.net/projects/qtioccontainer 
(3) http://michaelfeathers.typepad.com/michael feathers blog/2006/10/dependency. inje.html 
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值得 的 , 但 是 选择 这 样 的 方式 将 带 来 重用 的 机 会 和 更 灵活 的 设计 弹性 (如 可 以 用 多 态 的 方式 来 替 
K) 这样 你 在 创建 测试 替身 时 也 会 多 一 些 选 择 。 

另 一 种 方法 是 创建 更 加 过 程 化 、 弱 内 聚 的 代码 。 让 我 们 来 看 看 在 测试 后 行 的 世界 里 ， 一 个 
PlaceDescriptionService 的 典型 解决 方案 : 














c5/17/PlaceDescriptionService.cpp 


string PlaceDescriptionService::summaryDescription( 
const string& latitude, const string& longitude) const { 
// 通过 API 检 索 ]S0N 响 应 
response = ""; 
auto url - createGetRequestUrl(latitude, longitude); 
curl easy setopt(curl, CURLOPT URL, url.c str()); 
curl easy perform(curl); 
curl easy cleanup(curl); 


// 解析 JS0N 响 应 

Value location; 

Reader reader; 

reader.parse(response , location); 

auto jsonAddress - location.get("address", Value::null); 





// 填充 从 JSON 获 取 的 地 址 

Address address; 

address.road - jsonAddress.get("road", "").asString(); 
address.city - jsonAddress.get("hamlet", "").asString(); 
address.state - jsonAddress.get("state", "").asString(); 
address.country = jsonAddress.get("country", "").asString(); 


return address.road + ", " + address.city + ", " + 
address.state + ", " + address.country; 


) 

上 述 实现 的 代码 有 二 十 来 行 , 很 方便 读 考 阅读 , 尤其 是 引导 性 的 注释 。 这 是 典型 的 后 测试 代 
码 。 虽然 我 们 可 以 将 其 拆 成 多 个 更 小 的 函数 , 就 像 稍 早 前 的 做 法 一 样 , 但 是 开发 人 员 不 会 这 么 做 。 
测试 后 行 的 开发 者 不 习惯 定期 做 重 构 , 通常 ， 他 们 不 需要 使 用 快速 的 测试 来 让 重 构 变 得 更 快 、 更 
安全 。 这 又 怎么 样 呢 ? 像 这 样 的 代码 有 什么 不 妥 吗 ? 我 们 可 以 在 需要 的 时 候 去 重 构 它 。 


从 设计 的 角度 看 ,这 二 十 多 行 代码 违背 了 单一 责任 原则 一 一 需要 修改 summaryDescription() 
的 原因 有 多 个 : 首先 ， 这 个 函数 与 cURL 紧 密 耦 合 ; 其 次 ， 这 二 十 多 行 代码 的 函数 算 作 宛 长 函数 ， 
想 要 完全 理解 它 会 花费 很 多 时 间 。 

像 这 样 见 长 的 函数 容易 导致 不 必要 的 代码 重复 。 例 如 ， 其 他 服务 代码 也 有 可 能 需要 相同 的 
cURL 逻 辑 。 开 发 人 员 往 往 会 重复 编写 与 cURL 相 关 的 代码 ， 而 不 是 尝试 重用 。 重 用 始 于 一 些 可 重 
用 结构 的 独立 , 这些 结 构 更 容易 被 其 他 程序 员 识 别 。 如 果 潜 在 的 可 以 重用 的 代码 深 埋 于 宛 长 的 函 
数 中 ， 那 么 重用 将 不 会 发 生 。 

以 这 样 的 方式 来 开发 系统 会 让 你 的 代码 数量 加 倍 。 
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即便 如 此 ， 你 依然 可 以 测试 这 二 十 来 行 代码 。 你 也 可 以 使 用 link substitution 写 一 个 快速 的 单 
元 测试 ( 参见 8.9 节 )， 或 者 写 一 个 能 发 起 一 个 即时 的 REST 服 务 调用 的 集成 测试 。 但 是 由 于 此 类 
测试 会 大 一 些 ,， 因 此 在 单个 的 测试 中 就 会 有 多 个 设置 和 验证 动作 (但 总 体 而 言 , 构建 最 初 测试 的 
工作 量 没有 太 大 区 别 )。 集 成 测试 则 相对 慢 一 些 ， 而 且 不 稳定 。 

在 现实 世界 里 ， 比 这 二 十 来 行 代码 差劲 的 代码 比比 丝 是 。 当 然 ， 你 的 代码 看 起 来 会 好 一 些 ， 
因为 在 践 行 TDD 时 ， 你 会 寻求 高 内 聚 、 低 耦合 的 设计 。 你 会 开始 意识 到 灵活 设计 的 好 处 ， 也 会 很 
的 设计 是 怎样 与 测试 和 谐 共存 的 ， 而且 这 些 测试 具有 体 量 小 , 易于 编写 、 阅 读 和 维护 的 


快 发 现 好 


de 
REL 





















































5.8.2 ”转嫁 私有 依赖 





如 果 


你 不 担忧 测试 ， 那 么 PlaceDescriptionService 中 的 HTTP 调 用 可 以 保有 一 个 私有 依赖 ， 











这 


意味 着 PlaceDescriptionService 的 客户 端 程序 不 会 意识 到 HTTP 调 用 的 存在 。 但 是 ， 如 果 使 用 setter 
数 注入 , 那么 客户 端 程序 就 需要 创建 Http 对 象 , 并 把 它 传 给 PlaceDescriptionService 实 例 。 


或 构造 函 
这 样 ， 就 
开发 




















将 PlaceDescriptionService 对 HTTP 的 依赖 转嫁 给 客户 端 程序 了 。 
人 员 可 能 会 担忧 这 样 选择 的 后 果 。 

















提问 ， setter 或 构造 函数 注入 是 不 是 违反 了 信息 隐藏 ? 

回答 : 从 客户 端 程序 的 角度 来 说 ， 确 实 是 违反 了 。 但 你 可 以 使 用 其 他 依赖 
注入 方法 (参见 5.7 节 )。 即 使 某 人 利用 了 这 些 暴 露出 来 的 信息 ， 也 不 大 可 能 造 
成 不 好 的 影响 。 

此 外 ， 你 也 可 以 提供 一 个 默认 的 实例 。 我 们 可 以 先 配置 PlaceDescription- 
Service 使 其 包含 一 个 CurlHttp 实 例 , 如 果 测 试 提供 HttpStub 实 例 , 那么 它 将 会 被 
替代 。 而 真正 的 产品 客户 端 是 不 需要 做 什么 改动 的 。 

提问 : 如 果 心 怀 恶 意 的 开发 者 提供 一 个 具有 破坏 性 的 Http 实 例 呢 ? 

回答 : 如 果 产 品 的 客户 是 团队 之 外 的 人 ， 那 么 可 以 选择 其 他 注入 形式 。 
如 果 担 心 团队 内 部 的 开发 者 有 意 利用 注入 点 做 些 不 好 的 事 ， 那 你 将 面临 更 大 
的 问题 。 

提问 : 我 逐渐 能 够 测试 驱动 开发 了 , 但 我 担心 仅仅 为 了 测试 的 目的 而 改变 
我 的 设计 方法 。 我 的 团队 中 的 其 他 人 可 能 也 会 这 么 觉得 。 

回答 : 确切 地 了 解 软 件 能 如 期 工作 是 改变 设计 方式 的 重要 原因 。 你 可 以 这 
样 和 同事 讲 :“ 我 更 关心 代码 是 否 如 期 工作 。 做 出 这 么 一 个 小 的 让 步 意味 着 我 
们 能 够 更 容易 地 测试 代码 ， 也 会 有 更 多 的 测试 能 够 帮助 我 们 更 容易 地 打磨 设 
计 ， 我 们 也 会 对 代码 更 有 信心 。 所 以 你 们 能 重新 思考 下 我 们 的 标准 吗 ? ” 
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5.9 使 用 测试 蔡 身 的 策略 


使 用 测试 替身 和 其 他 工具 一 样 ， 最 大 的 挑 成 不 是 学 会 怎么 用 它们 ， 而 是 知道 什么 时 候 使 用 。 
本 节 将 描述 一 些 学 铂 的 意见 ， 并 给 出 合理 使 用 测试 替身 的 建议 。 














5.9.1 探索 设计 

现在 假设 AddressExtractor 不 存在 。 在 测试 驱动 开发 summaryDescription() 时 , 你 肯定 会 意 
识 到 需要 一 些 逻 辑 ， 它 能 接受 一 个 JSON 格 式 的 响应 ， 并 返回 一 个 格式 化 的 字符 串 。 你 可 以 在 
PlaceDescriptionService 中 全 部 自己 实现 这 个 逻辑 。 代 码 也 不 多 ( 从 现 有 的 AddressExtractor 代 码 看 ， 
也 就 十 来 行 )。 

一 些 程序 员 总 是 打 着 设计 者 的 旗号 ,寻求 有 潜在 重用 性 、 更 大 灵活 性 和 易于 理解 的 代码 的 设计 。 
为 了 遵守 单一 责任 原则 , 或 许可 以 将 所 需 的 逻辑 拆 分 成 两 块 : 解析 JSON 格 式 的 响应 和 格式 化 输出 。 


TDD RMR 不 ， 它 要 求 你 在 任何 时 候 都 要 做 出 清醒 的 设计 选择 。 实 现 summary- 
Descritpion() 的 方法 有 无 数 种 。 你 可 以 使 用 TDD 来 帮助 探索 这 些 设 计 。 通 常 , 这 从 一 段 可 以 工 
作 的 代码 开始 ， 然 后 重 构 至 合理 的 解决 方案 。 


你 也 可 以 先 写 一 个 用 来 描述 summaryDescription() 应 该 怎样 和 外 部 协作 者 交互 的 测试 。 这 
个 协作 者 的 工作 是 得 到 一 个 JSON 格 式 的 响应 ， 并 返回 相应 的 地 址 数据 结构 。 目 前 而 言 ， 我 们 可 
以 忽略 实现 这 个 协作 者 的 细节 , 先 集 中 使 用 mock 来 测试 驱动 开发 summaryDescription() ， 就 像 
我 们 为 和 Http 对 象 交 互 所 做 的 一 样 。 


当 以 这 种 方式 测试 驱动 开发 时 ， 可 以 通过 引入 mock 来 蔡 代 缺失 的 协作 者 行为 。 要 根据 客户 
端的 需求 为 协作 者 设计 接口 。 

在 某 一 时 刻 ， 你 或 其 他 人 将 会 实现 这 个 协作 者 。 这 时 你 可 以 作出 以 下 选择 : 移 除 mock， 以 
便 待 测试 的 代码 使 用 产品 级 的 协作 者 ;保留 mock。 

也 许 你 已 经 作 好 了 选择 。 如 果 协 作者 引入 麻烦 的 依赖 ， 那 么 就 需要 保留 mock。 否 则 ， 移 除 
mock 会 降低 测试 的 复杂 度 。 但 是 ， 你 也 许 选择 保留 它 ， 特 别 是 需要 用 它 来 描述 与 协作 者 的 交互 
式 设计 中 的 重要 方面 。 

或 许 最 好 的 指导 方针 需要 考虑 维护 和 理解 测试 所 需 的 精力 。 如 果 没 有 mock， 事 情 可 能 会 简 
单 些 ， 但 不 总 是 这 样 的 。mock 可 能 需要 大 量 的 代码 来 初始 化 一 些 协作 者 ， 这 也 会 增加 维护 测试 
的 成 本 。 


































































































太 多 的 模拟 ? 
在 2003 年 的 7 个 月 里 ,我 在 一 个 大 型 Java 开 发 团队 中 担任 程序 员 并 践 行 XP。 
刚 到 的 时 候 , 我 看 到 大 量 的 单元 测试 时 很 激动 , 但 是 当 看 到 测试 的 质量 或 产品 
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5.9.2 


把 TDD 用 于 设计 探索 的 开发 者 属于 伦敦 流派 。 这 一 流派 的 的 创始 人 包括 Tim Mackinnon, 
Seteve Freeman 和 Philip Craig， 他 们 首先 发 表 了 关于 mock 的 论文 (Endo-Testing: Unit Testing with 
Mock Objects [MFC01] )。 由 Freeman 和 Nat Pryce 合 著 并 获得 高 度 好 评 的 Growing Object-Oriented 


代码 的 质量 时 就 没 那么 兴奋 了 。 这 两 部 分 代码 虽说 不 是 那么 糟糕 ,但 是 我 发 现 
了 许多 重复 的 代码 ， 宛 长 的 方法 和 测试 ， 以 及 大 量 使 用 的 mock。 然 而 ， 系 统 
却 可 以 正常 工作 ， 也 没 暴 露出 过 多 缺陷 。 

几 个 月 过 后 ， 当 我 尝试 将 系统 用 户 从 11 个 增加 到 50 多 个 时 ， 出现 了 性 能 问 
题 。 所 有 迹象 表明 问题 出 在 没有 很 好 地 利用 中 间 件 框架 。 后 来 ， 一 个 收费 颇 高 
的 中 间 件 框架 专家 和 我 们 的 团队 紧密 合作 来 重 整 代码 。 

可 以 利用 控制 器 级 别 的 mock 查 看 是 否 按 照 一 定 的 顺序 调用 方法 ， 
证 事件 发 生 的 顺序 。( 更 糟糕 的 是 ， 他 们 使 用 的 工具 要 求 以 字符 串 的 方式 给 
函数 的 期 望 。 重 命名 一 个 方法 意 NE 
X, RHONE A 么 抽象 。 当 优化 团队 开始 重 整 代 码 以 提高 常 要 改 
Li 给 定 消 息 流 的 设计 。 这 就 需要 把 方法 移 来 移 去 、 pe ur a 

法 合 二 为 一 、 删 掉 一 些 方法 ， 等 等 。 每 当 他 们 做 这 样 的 改动 …… 哦 ! 测试 失败 
了 ， 有 时 候 一 次 改动 会 导致 十 来 个 代码 的 失败 。 

由 于 测试 紧密 地 和 目标 实现 耦合 在 一 起 ， 因 此 重 整 代码 会 变 得 非常 缓慢 。 
副 总 裁 和 其 他 反对 者 开始 抱 她 。 所 有 的 程序 员 SECUN PUN 

如 果 测 试 严 重 依赖 具体 实现 ( 以 特定 的 顺序 调用 特定 的 函数 ) 的 话 ， 那 么 
就 会 导致 严重 的 问题 。 事 后 看 来 ， 更 大 的 问题 来 自 于 不 充分 的 系统 设计 。 如 果 
去 掉 测 试 中 的 重复 , 可 能 会 让 我 们 更 加 轻松 。 另 一 个 严重 的 问题 是 没有 合适 的 
性 能 和 伸缩 性 测试 。 





mock 流派 























Software, Guided by Tests [FP09] 中 集中 讨论 了 使 用 TDD 来 开发 系统 。 

















合 的 设计 。 


经 典 流派 ( 有 时 又 称 作 Cleveland 流 派 ) 强调 通过 查看 状态 来 验证 行为 。Ken Beck 的 《测试 驱 
动 开发 ( 中 文 版 )》 几 乎 完全 集中 于 TDD 方 式 。 这 一 学 
mock, 
引入 mock 会 让 测试 对 其 测试 目标 内 部 的 实现 产生 依赖 。 如 果 你 使 用 一 个 工具 ， 同 样 也 会 依 
赖 这 个 工具 。 如 果 操 作 期 间 粗 心 的话 , 那么 这 两 种 依赖 会 让 设计 变 得 不 灵活 , 而 且 测 试 也 不 稳定 。 




















由 于 伦敦 学 派 强 调 对 象 间 的 交互 , 因此 它 也 促进 了 Tell-Don'fAsk 的 理念 的 发 展 。 在 面向 对 象 
的 系统 中 , 你 (一 个 客户 端 对 象 ) 向 一 个 对 象 发 送 消息 来 告诉 它 要 完成 的 任务 , 并 让 它 自 主 完成 。 


你 不 需要 查询 对 象 信息 然后 完成 可 能 在 这 个 对 象 职责 范围 内 的 任务 .Tell-Don'tAsk 众 
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派 的 开发 者 在 依赖 关系 引起 问题 时 才 引 入 
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预防 这 一 问题 的 最 好 方法 是 : 隔离 并 最 小 化 它们 。 
与 此 同时 ， 开 发 者 也 要 为 使 用 mock 带 来 的 额外 复杂 度 买 单 (我 就 曾 花 费 了 数 分 钟 来 找 出 一 
个 mock 声 明 错 误 )。 


作为 专业 人 员 , 你 应 该 对 这 两 种 流派 的 方法 有 所 了 解 。 虽然 你 可 能 会 选择 遵循 其 中 的 一 个 流 
派 ， 但 依然 可 以 将 伦敦 流派 和 经 典 流派 的 元 素 纳入 到 TDD 实 践 中 。 




















5.9.3 ”明智 地 使 用 测试 替身 


如 果 你 要 彻头彻尾 地 测试 驱动 开发 一 个 带 有 快速 测试 的 系统 , 这 其 中 的 大 部 分 系统 都 需要 使 
用 测试 替身 。 在 使 用 测试 替身 时 ， 可 以 参考 下 面 的 建议 。 














重新 思考 设计 。 你 是 为 了 简化 依赖 对 象 的 创建 而 使 用 mock 的 吗 ? 如 果 是 
的 话 ， 那 么 重新 修改 依赖 结构 。 你 是 不 是 在 多 个 地 方 为 同一 个 东西 使 用 了 
mock? 如 果 是 的 话 ， 那 么 重新 设计 来 消除 这 样 的 重复 。 

意识 到 单元 测试 覆盖 率 上 的 让 步 。 一 个 测试 替身 代表 了 系统 测试 覆盖 率 的 
漏洞 。 因 为 测试 替身 提供 的 逻辑 正 是 单元 测试 所 不 能 履 盖 的 ， 所 以 一 定 要 确保 
其 他 测试 履 盖 到 这 部 分 逻辑 。 

重 构 测试 。 不 能 让 对 第 三 方 工具 的 依赖 成 为 问题 。 使 用 随意 的 方法 会 导致 
mock 的 大 量 增加 ， 也 会 导致 大 量 的 重复 和 复杂 难 懂 的 测试 。 要 像 重 构 产 品 代 
码 那 样 去 重 构 测试 | 把 期 望 声明 封装 进 一 个 公共 的 辅助 函数 能 够 提高 抽象 、 降 
低 依 赖 度 、 减 少 重复 代码 。 当 你 日 后 想 升级 到 一 个 更 新 的 、 比 Google mock € 
好 用 的 工具 的 时 候 ， 就 不 再 需要 做 非常 大 的 改动 。 

质疑 以 过 度 复杂 的 方式 使 用 测试 苦 身 。 如 果 你 身 陷 mock， 那 可 能 是 因为 
你 尝试 了 过 度 测试 或 你 的 设计 有 缺陷 。 这 时 使 用 多 级 的 mock 通 常 能 解决 问题 。 
而 使 用 Fake ( 参见 5.10 节 ) 往往 会 导致 更 多 的 问题 。 如 果 遇 到 了 问题 ， 那 么 就 
要 将 测试 分 解 为 多 个 小 的 测试 来 简化 问题 。 同 样 也 要 检测 一 下 所 测 代 码 是 否 可 
以 拆 解 。 

表达 力 胜 于 功能 。 选 择 mock 工 具 是 因为 它 能 帮助 你 创建 高 度 抽 象 的 测试 ， 
这 些 测试 可 以 文档 化 系统 行为 和 设计 ， 而 不 仅仅 是 因为 它 有 很 酷 的 功能 ， 可 以 
做 精巧 和 深奥 的 事情 。 除 非 必要 ， 否 则 不 要 使 用 这 些 精巧 深奥 的 功能 。 


5.40 ”其 他 关于 测试 替身 的 主题 


我 们 将 在 最 后 这 一 节 中 学 习 一 些 使 用 测试 奉 身 的 零散 知识 , 包括 广泛 接受 的 术语 、 该 在 哪 定 
义 它 们 、 该 不 该 模拟 具体 的 类 ， 还 有 它们 对 性 能 的 影响 。 
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5.10.1 怎么 称呼 它们 


到 目前 为 止 , 本 章 中 使 用 的 术语 有 测试 替身 、mock 和 Stub。TDD 社 区 中 的 大 部 分 人 都 接受 了 
这 些 术语 的 定义 ， 还 有 一 些 对 你 或 许 有 用 的 术语 。 你 会 经 常 听 到 用 mock 来 取代 测试 替身 。 大 部 
分 时 候 ， 这 是 合适 的 ， 因 为 大 部 分 开发 者 都 使 用 mock 工 具 。 但 是 ， 如 果 想 要 更 顺畅 地 沟通 的 话 ， 
那么 就 要 依据 所 处 的 环境 来 使 用 最 合适 的 术语 。xUnit Test Patterns [Mes07] 为 这 些 定 义 提 供 了 权 
威 解释 。 























测试 蔡 身 : 为 测试 而 模拟 产品 代码 的 代码 。 

Stub: 一 个 返回 硬 编码 值 的 测试 替身 。 

Spy: 一 个 保存 接受 信息 以 便 日 后 验证 的 测试 替身 。 

mock: 一 个 基于 期 望 自我 验证 的 测试 替身 。 

Fake: 提供 产品 类 轻 量 级 实现 的 测试 替身 。 

我 们 为 get () 手 工 打造 的 测试 替身 既是 一 个 Stub 也 是 一 个 Spy。 说 它 是 Spy， 是 因为 它 验 证 收 

到 的 URL 包 含 一 个 正确 的 HTTP GET 请 求 的 URL。 说 它 是 Stub ， 是 因为 它 返回 了 硬 编码 的 JSON 文 
本 。 之 后 ， 我 们 用 Google Mock 将 之 实现 为 mock， 用 来 捕获 期 望 ， 并 自动 验证 期 望 是 否 满足 。 


内 存 数据 库 "是 Fake 的 典型 例子 。 因 为 和 基于 文件 系统 的 数据 库 交 互 本 身 很 慢 ， 所 以 许多 团 
队 实现 了 一 个 测试 替身 , 用 来 模拟 大 部 分 与 数据 库 的 交互 。 其 底层 的 实现 一 般 是 基于 哈 希 的 数据 
结构 ， 它 提供 了 简单 且 快 速 基于 键 值 的 查询 。 

使 用 Fake 带 来 的 挑战 是 它 成 为 一 个 firstrate 类 ， 通 常 实现 也 会 变 得 复杂 ， 这 样 可 能 自身 就 有 
缺陷 。 例 如 ， 如 果 使 用 数据 库 Fake 的 话 ， 就 必须 基于 哈 希 的 实现 正确 地 完成 数据 库 的 语义 交互 。 
这 是 可 以 做 到 的 ， 但 也 容易 犯错 。 

尽量 不 要 使 用 Fake。 不 然 你 肯定 会 花费 半 个 下 午 才能 找到 由 Fake 自 身 的 小 缺陷 导致 的 问题 
(我 就 有 这 样 的 经 历 )。 测 试 集 的 存在 是 为 了 简化 和 加 速 开发 ， 而 不 是 自 找 麻 烦 ， 浪 费时 间 。 

如 果 你 坚持 使 用 Fake， 那么 就 要 保证 Fake 自 身 能 够 通过 单元 测试 。 为 Fake 开 发 的 测试 需要 证 
明 其 行为 和 模拟 的 对 象 一 致 。 






































































































































5.10.2 ”测试 替身 该 放 在 哪 


一 开始 在 相同 的 测试 文件 中 定义 测试 蔡 身 , 以 便 开 发 者 看 到 。 当 多 个 fixture 使 用 同一 个 测试 
蔡 身 时 ， 再 将 声明 移植 到 单独 的 头 文件 中 。 当 不 再 需要 查看 测试 替身 时 ， 应 该 把 它们 从 视野 中 
移 除 。 


















































(D in-memory database 将 数据 库 的 所 有 数据 放 在 内 存 中 ， 可 以 加 速 数据 库 的 访问 ， 这 样 就 加 快 测试 的 执行 速度 。 
一 一 译 者 注 
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你 需要 记 住 的 是 ， 修 改 产 品 接口 会 导致 使 用 测试 替身 的 测试 失败 。 如 果 你 们 同 在 一 个 团队 ， 
遵守 集体 代码 所 有 权 准 则 〈 每 个 人 都 有 权 修 改 任何 代码 )， 那 么 修改 产品 代码 的 程序 员 就 要 负 
责 运行 所 有 的 测试 并 修复 所 有 的 问题 。 在 其 他 情况 下 ， 最 好 发 个 消息 清楚 地 传达 改动 及 其 影响 。 








NE 





5.10.3 虚 函 数 表 和 性 能 


引入 测试 蔚 身 是 为 了 测试 驱动 开发 一 个 有 复杂 依赖 关系 的 类 。 许多 创建 测试 替身 的 技术 都 需 
要 创建 派生 类 来 覆 写 虚 成 员 函 数 。 如 果 之 前 的 产品 类 没有 虚 函 数 , 那么 现在 会 有 , 并且 会 有 一 个 
虚 函 数 表 。 虚 函数 表 带 来 额外 的 间接 性 是 有 开销 的 。 

引入 虚 函 数 表 会 引起 对 性 能 的 担忧 ， 因 为 C++ 需要 在 虚 函 数 表 中 做 额外 的 查询 ( 而 不 是 简单 
地 调用 一 个 函数 )。 而 且 ， 编 译 器 不 能 内 联 一 个 虚 函 数 。 

但 是 , 在 大 多 数 情 况 下 ， 虚 函数 表 带 来 的 性 能 影响 可 以 忽略 不 计 甚 至 没有 影响 。 在 特定 情形 
下 ， 编 译 需 能 够 优化 这 些 开 销 。 大 部 分 时 候 ， 你 会 想 要 一 个 更 好 的 、 多 态 的 设计 。 

然而 ， 如 果 你 必须 大 规模 地 调用 模拟 的 产品 函数 ,那么 就 需要 先 得 到 一 些 性 能 数据 。 如 果 
性 能 降 到 不 可 接受 的 程度 ， 就 要 考虑 不 同 的 模拟 方式 (或许 基 于 模板 的 方案 )， 重 新 设计 (可 
能 的 话 ， 通 过 优化 其 他 地 方 来 补偿 性 能 损失 ), 或 者 引入 集 成 测试 来 弥补 单元 测试 的 不 足 ( 参 
见 10.2 节 )。 
















































































5.10.4 ”模拟 具体 的 类 


在 前 面 的 示例 中 , 我 们 通过 实现 一 个 纯 虚 的 Http 接 口 来 创建 一 个 mock。 很 多 系统 主要 由 具体 
的 类 构成 ,因此 没有 多 少 此 类 接口 。 从 设计 的 角度 讲 , 使 用 接口 是 将 系统 中 的 一 部 分 和 男 一 部 分 
隔离 的 方式 。 依 赖 倒置 原则 (Dependency Inversion Principle, DIP ) "提倡 让 客户 端 依 赖 抽象 的 
接口 而 非 具 体 的 实现 ， 从 而 达到 消除 依赖 的 目的 。 以 纯 虚 类 的 方式 引入 这 种 抽象 ,能 够 加 快 编译 
并 隔离 复杂 性 。 更 重要 的 是 ， 它 们 能 让 测试 变 得 简单 。 

如 果 是 必须 的 话 ， 你 可 以 创建 一 个 派生 自 一 个 具体 类 的 mock。 问 题 是 产生 的 类 混合 了 产品 
代码 和 模拟 的 行为 ， 这 又 被 称 为 部 分 模拟 。 首 先 ， 部 分 模拟 通常 能 告诉 你 所 模拟 的 类 过 大 ， 如 果 
你 只 需要 其 中 的 一 部 分 而 不 是 全 部 ,那么 就 可 以 按照 这 些 边界 将 类 拆 分 成 两 个 。 其次, 使 用 部 分 
模拟 很 可 能 使 你 陷入 麻烦 ， 以 至 于 很 快 陷 入 模拟 地 狱 。 

如 果 你 想 通 过 定义 一 个 派生 类 来 直接 模拟 CurlHttp， 那 么 你 就 会 默认 调用 它 的 析 构 函数 。 这 
样 做 有 什么 问题 吗 ? 或 许 会 有 问题 ， 因 为 它 正 好 直接 与 CURL 库 交互 。 也 许 你 不 希望 你 的 测试 是 
这 样 的 。 在 一 些 情况 下 ， 你 也 可 能 遇 到 诡秘 的 问题 :“ 啊 ! 我 原 以 为 代码 此 时 会 与 模拟 的 方法 交 
互 ， 但 是 看 起 来 它 与 真正 的 方法 交互 了 。” 你 肯定 不 想 经 常 浪费 时 间 来 解决 此 类 问题 。 
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如 果 你 使 用 诸如 部 分 模拟 此 类 难以 驾驭 的 工具 , 那么 你 的 设计 正 散 发 着 坏 味 。 举 例 来 说 ,一 
个 干净 的 设计 会 采用 具体 类 继承 一 个 接口 的 方式 。 这 样 ， 测试 也 不 再 需要 部 分 模拟 了 ,为 这 个 接 
口 创建 一 个 测试 蔡 身 即 可 。 












































5.11 ”结束语 


本 章 中 介绍 了 一 些 可 以 在 测试 驱动 开发 时 使 用 的 技巧 , 使 用 这 些 技巧 可 以 打破 对 协作 者 的 依 
赖 。 你 需要 查看 模拟 工具 的 文档 来 完全 理解 其 额外 的 特性 及 细微 差别 。 另 外 , 你 现在 已 经 对 TDD 
中 构建 产品 级 系统 所 需 的 核心 机 制 有 了 基本 的 理解 。 

然而 ,这 并 不 意味 着 你 可 以 停止 阅读 ,特别 是 想 获 得 长 远 的 成 功 的 情况 下 。 我 们 才刚 刚 开 始 
学 到 有 用 的 东西 。 既 然 可 以 测试 驱动 开发 所 有 的 代码 , 那么 怎样 利用 它 才 能 让 设计 保持 干净 和 简 
约 呢 ? 怎样 确保 测试 也 保持 干 交 和 简单 呢 ? 我 们 在 接 下 来 的 两 章 将 集中 讨论 如 何 提升 产品 代码 
和 测试 的 设计 ， 让 维护 开销 一 直 处 于 最 小 。 















































第 6 章 
增 量 设计 








6.1 开场 白 


从 机 制 到 推荐 的 实践 ,再 到 应 对 依赖 的 各 种 技巧 , 你 已 经 学 习 了 TDD 的 核心 基础 , 一 路 上 也 
在 不 断 重 构 "， 以 每 个 改动 增 量 地 打磨 代码 ， 但 是 什么 时 候 才能 结束 呢 ? 


使 用 TDD 的 主要 原因 是 ,能 够 以 可 承受 的 、 稳 定 的 维护 成 本 来 添加 或 修改 功能 特性 。 通 过 在 
改动 系统 时 人 允许 持续 地 改进 设计 ,TDD 提 供 了 这 种 支持 。TDD 实 践 产生 的 测试 证 明 , 系统 的 逻辑 
是 按 预 期 的 方式 工作 的 ， 你 可 以 在 加 入 新 代码 后 整理 代码 。 这 对 我 们 来 说 意义 重大 。 没 有 TDD， 
你 就 不 能 得 到 快速 的 反馈 ， 也 不 能 安全 、 容 易 地 做 增 量 的 代码 改动 。 如 果 不 能 增 量 地 修改 代码 ， 
你 的 代码 库 会 逐渐 退化 。 

在 本 章 中 ， 你 将 学 到 重 构 过 程 中 需要 做 的 事情 。 我 们 将 主要 讨论 Kent Beck 提 出 的 简单 设计 
理念 (参见 《解析 极限 编程 ， 拥抱 变化 》)， 以 及 可 以 保持 代码 整洁 的 一 系列 重要 规则 。 























6.2 简单 设计 
如 果 你 对 设计 一 无 所 知 ， 那 么 在 使 用 TDD 时 需要 考虑 以 下 三 条 简单 规则 。 
口 确保 代码 具备 很 强 的 可 读 性 和 表达 力 。 
O 在 和 第 一 条 规则 不 冲突 的 情况 下 ， 消 除 所 有 的 重复 。 
O 不 要 向 系统 引入 不 必要 的 复杂 性 。 避 人 免 猜 测 性 的 结构 关系 (“我 只 知道 总 有 一 天 我 们 不 得 
不 支持 多 对 多 的 关系 ”) 和 不 能 增强 系统 表达 力 的 抽象 。 
虽然 最 后 一 条 规则 很 重要 , 但 是 其 他 两 个 优先 级 更 高 。 换 名 话说 ， 如 果 新 的 成 员 函 数 或 类 能 
够 提升 表达 力 的 话 ， 那 么 就 加 入 这 一 抽象 好 了 。 

















(D XP ( eXtream Programming ) 的 创始 人 及 重 构 的 倡导 者 Kent Beck 对 重 构 做 了 一 个 精彩 的 总 结 : 了 解 并 实践 重 构 技 
术 只 是 你 登 党 入 室 的 一 块 需 门 砖 。 在 重 构 的 历程 中 ， 如 果 哪 天 你 可 以 自信 满 满 地 停止 重 构 ， 那 才 是 真正 的 得 道 。 
一 _ 译 者 注 
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恪守 这 些 规则 能 够 让 你 的 系统 可 维护 性 变 得 特别 好 。 


6.2.1 重复 代码 的 代价 

在 代码 示例 中 ,我们 对 消除 重复 代码 关注 颇 多 。 但 这 是 为 什么 呢 ? 

随 着 时 间 的 推移 , 重复 代码 或 许 是 维护 代码 库 的 最 大 开销 。 试想 一 下 ,你 的 系统 需要 用 两 行 
代码 来 审查 一 些 重要 的 事件 。 当 然 , 这 两 行 代码 可 以 放 在 一 个 辅助 性 的 成 员 函 数 中 , 但 只 有 两 行 
代码 , 对 吧 ? 当 需 要 增加 一 个 待 审查 的 事件 时 , 最 简单 的 方式 就 是 找到 另 一 个 审查 点 , 然后 复制 、 
粘贴 这 两 行 代码 。 

两 行 重复 代码 听 起 来 没 那么 糟 ， 但 如 果 这 两 行 代码 在 你 的 整个 代码 库 中 重复 了 100 次 ， 情 况 
会 怎样 ”再 想 想 ， 如 果 审 查 的 需求 要 修改 一 下 ， 需 要 加 入 第 三 行 代码 。 噢 喔 ! 你 必须 找 出 100 个 
需要 修改 的 地 方 , 加 上 这 行 代码 , 然后 重新 运行 所 有 测试 , 这 样 的 成 本 远 比 只 改 一 个 地 方 要 高 得 
多 。 如 果 其 中 一 处 的 重复 代码 稍 有 不 同 呢 ? 你 必须 花费 额外 的 时 间 进 行 分 析 , 来 断定 这 个 重复 代 
码 的 变 体 是 不 是 有 意 的 。 如 果 你 只 找到 99 个 重复 点 却 漏 掉 了 第 100 个 重复 点 呢 ? 那么 你 就 发 布 了 
有 缺陷 的 代码 。 

大 多 数 开发 者 懒 于 创建 新 的 成 员 函 数 , 因为 怀疑 这 会 降低 性 能 , 所 以 他 们 有 时 甚至 会 拒绝 这 
样 做 。 最 终 ， 他 们 只 是 为 自己 创造 了 更 多 的 未 来 工作 量 。 

这 不 是 导致 重复 代码 的 唯一 途径 。 试 想 你 被 告知 要 添加 一 个 已 有 特性 的 变 体 。 这 需要 你 改动 
六 行 代码 ， 如 果 条 件 满足 ， 就 执行 它们 ， 和 否则 执行 已 有 的 六 行 代码 。 

你 发 现 已 有 的 特性 是 一 个 未 经 测试 的 、 约 200 行 代码 的 成 员 函 数 。 正 确 的 设计 方式 是 抽取 195 
行 左右 的 公共 代码 行 ， 并 允许 用 扩展 的 方式 引入 变 体 。 或 许 模板 方法 或 策略 "设计 模式 可 为 此 方 
案 提供 基础 。 

大 部 分 程序 员 没 能 正确 实现 ， 不 是 因为 他 们 不 知道 怎么 做 ， 而 是 因为 他 们 懒得 做 、 不 敢 做 。 
“如 果 改 变 已 有 的 代码 破坏 了 功能 ,我 会 因此 受到 责备 的 ,我 不 该 一 开始 就 乱 来 。” 这 样 做 更 容易 
些 : 复制 200 行 代码 ， 修 改 好 后 继续 工作 。 

由 于 对 重复 的 自然 倾向 , 大 部 分 大 型 系统 的 代码 远 远 多 于 实际 需要 的 代码 。 这 些 额 外 的 代码 
大 大 地 增加 了 维护 成 本 和 风险 。 


将 增 量 重 构 作 为 TDD 环 节 的 一 部 分 可 以 避免 系统 级 的 退化 。 










































































































































































6.2.2 ”投资 管理 器 
让 我 们 看 看 Beck 的 简单 设计 理念 在 开发 小 型 子 系统 时 是 怎样 发 挥 作用 的 。 























(D 可 参考 《设计 模式 》 中 的 行为 模式 一 章 。 一 一 译 者 注 
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场景 : 投资 管理 器 
投资 人 想 要 跟踪 股票 买卖 记录 ， 并 将 此 作为 金融 分 析 的 基础 。 
经 过 努力 , 我 们 在 测试 驱动 投资 管理 器 中 得 到 了 下 面 代码 。( 注意 , 这 个 示例 的 大 部 分 代码 是 
在 幕后 构建 的 。 我 将 仅 展 示 与 设计 讨论 相关 的 部 分 。 可 以 通过 下 载 的 源 代 码 来 查看 完整 的 代码 。) 




















c6/1/PortfolioTest.cpp 


*include "gmock/gmock.h" 
#include "Portfolio.h" 


using namespace ::testing; 


class APortfolio: public Test ( 
public: 

Portfolio portfolio ; 
NH 


TEST F(APortfolio, IsEmptyWhenCreated) 1 
ASSERT TRUE(portfolio .IsEmpty()); 
} 


TEST_F(APortfolio, IsNotEmptyAfterPurchase) { 
portfolio_.Purchase("IBM", 1); 


ASSERT_FALSE(portfolio_.IsEmpty()); 





} 
TEST F(APortfolio, AnswersZeroForShareCountOfUnpurchasedSymbol) { 
ASSERT THAT(portfolio .ShareCount("AAPL"), Eq(0u)); 


} 


TEST_F(APortfolio, AnswersShareCountForPurchasedSymbol) { 
portfolio_.Purchase("IBM", 2); 
ASSERT_THAT (portfolio_.ShareCount ("IBM"), Eq(2u)); 


c6/1/Portfolio.h 


#ifndef Portfolio_h 
#define Portfolio_h 


#include <string> 


class Portfolio { 
public: 
Portfolio(); 
bool IsEmpty() const; 
void Purchase(const std::string symbol, unsigned int shareCount); 
unsigned int ShareCount(const std::string& symbol) const; 


private: 
bool isEmpty ; 
unsigned int shareCount ; 





#endif 


c6/1/Portfolio.cpp 
#include "Portfolio.h" 
using namespace std; 
Portfolio::Portfolio() 
: isEmpty [true] 
, shareCount {Qu} { 
} 
bool Portfolio::IsEmpty() const { 
return isEmpty_; 


} 


void Portfolio::Purchase(const string& symbol, unsigned int shareCount) { 
isEmpty_ = false; 
shareCount_ = shareCount; 


} 


unsigned int Portfolio::ShareCount(const string& symbol) const { 
return shareCount ; 


) 


你 能 够 通过 阅读 测试 知道 Portfolio 类 的 功能 吗 ? 你 应 当 养 成 习惯 ， 通 过 阅读 测试 名 称 来 了 解 
一 个 类 的 设计 意图 。 测 试 就 是 你 的 理解 途径 。 


























6.2.3 ”投资 管理 器 中 的 简单 重复 


测试 和 产品 代码 中 都 存在 重复 代码 。 字 符 串 "IBM" 在 两 个 测试 中 就 重复 了 3 次 : TEISNotEmpty- 
AfterPurchase 中 出 现 一 次 , 在 AnswersShareCountForPurchasedSymbol 中 出 现 2 次 。 将 字符 串 提 取 为 
常量 能 使 其 更 易 读 ， 同 时 降低 了 日 后 在 代码 中 拼 错 的 风险 ， 还 使 得 编写 新 的 测试 更 简单 。 此 外 ， 
如 果 要 变更 IBM 的 符号 ， 在 一 个 地 方 就 可 以 完成 修改 。 














c6/2/PortfolioTest.cpp 


#include "gmock/gmock.h" 
Zinclude "Portfolio.h" 


using namespace ::testing; 
using namespace std; 


class APortfolio: public Test { 
public: 
» static const string IBM; 
Portfolio portfolio ; 
}; 
> const string APortfolio::IBM("IBM"); 
Ti es 
TEST F(APortfolio, IsEmptyWhenCreated) { 
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ASSERT TRUE(portfolio .IsEmpty()); 
} 


TEST_F(APortfolio, IsNotEmptyAfterPurchase) { 
portfolio_.Purchase(IBM, 1); 
ASSERT_FALSE(portfolio_.IsEmpty()); 

} 

I1- xa 

TEST F(APortfolio, AnswersZeroForShareCountOfUnpurchasedSymbol) { 
ASSERT THAT(portfolio .ShareCount("AAPL"), Eq(0u)); 

} 

TEST_F(APortfolio, AnswersShareCountForPurchasedSymbol) { 
portfolio_.Purchase(IBM, 2); 


ASSERT_THAT (portfolio_.ShareCount(IBM), Eq(2u)); 
} 


TEST F(APortfolio, Throws0nPurchase0fZeroShares) { 
ASSERT THROW(portfolio .Purchase(IBM, 0), InvalidPurchaseException); 
} 


这 是 不 是 就 意味 着 遇 到 相同 的 字符 串 就 要 提取 为 变量 呢 ? 假设 AnswersShareCountFor- 
PurchasedSymbol 只 是 一 个 需要 字符 串 "IBM" 的 测试 。 创 建 一 个 局 部 变量 IBM 会 赋予 我 们 之 前 所 说 
的 好 处 。 但 是 这 种 情况 下 , 变量 的 值 似 乎 意义 并 不 大 。 我 们 可 以 轻易 地 看 出 这 个 测试 中 使 用 字符 
串 的 地 方 ， 所 以 这 是 无 足 轻重 的 。 如 果 需 要 的 话 ， 也 可 以 安全 地 改动 它们 。 


设计 往往 就 是 作出 判断 。 尽 力 恪守 本 音 开 头 提出 的 设计 原则 可 以 更 好 地 理解 你 的 系统 是 怎样 
从 中 获 益 的 。 有 了 这 样 的 经 验 后 ， 当 遇 到 需要 作出 判断 的 代码 时 ,你 就 能 理解 据 弃 设计 规则 的 影 
响 了 。 


阅读 以 下 产品 代码 ， 看 看 你 能 不 能 找 出 重复 代码 : 


















































二 





c6/1/Portfolio.cpp 
#include "Portfolio.h" 
using namespace std; 
Portfolio::Portfolio() 
: isEmpty [true] 
, shareCount (0u) 1 
} 
bool Portfolio::IsEmpty() const { 
return isEmpty_; 


} 


void Portfolio::Purchase(const string& symbol, unsigned int shareCount) { 
isEmpty = false; 
shareCount = shareCount; 


} 


unsigned int Portfolio::ShareCount(const string& symbol) const { 
return shareCount ; 


} 
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从 视觉 角度 来 看 ,代码 并 没有 明显 的 行 与 行 (或 表达 式 与 表达 式 ) 的 重复 。 但 其 中 存在 算法 
级 的 重复 。 成 员 函 数 IsEmpty() 返 回 一 个 布尔 量 ， 这 个 布尔 量 会 在 Purchase() 被 调用 时 更 改 。 
但 是 ， 空 的 概念 却 直接 绑 定 了 股票 数目 ， 股 票数 目 会 在 调用 Purchase() 时 被 赋值 。 通 过 去 除 
isEmpty 变量， 让 IsEmpty() 查 询 股票 的 数量 ， 我 们 可 以 消除 这 一 概念 重复 。 



































c6/2/Portfolio.cpp 


bool Portfolio::IsEmpty() const { 
» return 0 == shareCount ; 


} 

(是 的 ， 通 过 查询 股票 数量 来 决定 空 不 是 很 方便 ， 但 目前 来 说 是 正确 的 ， 换 句 话 说， 以 增 量 
的 思维 来 开发 。 知 道 自己 在 编写 临时 代码 可 能 会 激发 一 些 有 趣 的 想法 ， 从 而 促进 新 测试 的 产生 。 
实现 存在 的 问题 是 ,如 果 某 人 购买 了 0 股 某 股票 ,portfolio 会 返回 空 ,我 们 对 于 空 的 定义 是 ,portfolio 
是 否 包含 任何 股票 。 所 以 , 这 是 空 吗 ? 或 者 , 我 们 是 不 是 应 该 不 允许 这 笔 买 人 ? 为 了 能 继续 推进 ， 
我 们 选择 后 者 ， 写 一 个 名 为 ThrowsOnPurchaseOfZeroShares 的 测试 。) 

算法 的 重复 〈 解决 同一 问题 的 不 同方 法 或 问题 的 不 同 部 分 ) 会 随 系 统 增长 演变 为 重大 问题 。 
通常 来 说 ， 随 着 对 一 个 实现 的 改动 未 能 编写 进 其 他 实现 ， 重 复 代 码 会 演化 为 不 经 意 的 变 体 。 









































6.2.4 我们 真 的 能 坚持 增 量 方法 吗 


经 过 一 段 时 间 的 编码 后 , 我 们 得 到 了 如 下 的 一 些 测试 ( 目前 仅 是 一 些 测试 名 称 ， 因 为 你 应 该 
能 想象 出 这 些 测试 是 做 什么 的 ) …… 





c6/3/PortfolioTest.cpp 


TEST F(APortfolio, IsEmptyWhenCreated) { 

TEST F(APortfolio, IsNotEmptyAfterPurchase) { 

TEST F(APortfolio, AnswersZeroForShareCountOfUnpurchasedSymbol) { 

TEST F(APortfolio, AnswersShareCountForPurchasedSymbol) { 

TEST F(APortfolio, ThrowsOnPurchaseOfZeroShares) { 

TEST F(APortfolio, AnswersShareCountForAppropriateSymbol) { 

TEST F(APortfolio, ShareCountReflectsAccumulatedPurchasesOfSameSymbol) ( 
TEST F(APortfolio, ReducesShareCountOfSymbolOnSell) (1 

TEST F(APortfolio, ThrowsWhenSellingMoreSharesThanPurchased) { 


类 的 实现 如 下 : 





c6/3/Portfolio.cpp 


#include "Portfolio.h" 

using namespace std; 

bool Portfolio::IsEmpty() const { 
return 0 == holdings .size(); 

} 

void Portfolio::Purchase(const string& symbol, unsigned int shareCount) { 
if (0 == shareCount) throw InvalidPurchaseException(); 
holdings [symbol] = shareCount + ShareCount(symbol); 

} 
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void Portfolio::Sell(const std::string& symbol, unsigned int shareCount) { 
if (shareCount » ShareCount(symbol)) throw InvalidSellException(); 
holdings [symbol] = ShareCount(symbol) - shareCount; 

} 


unsigned int Portfolio::ShareCount(const string& symbol) const { 
auto it = holdings .find(symbol); 
if (it -- holdings .end()) return 0; 
return it-»-second; 


) 
这 个 时 候 ， 我 们 被 告知 一 个 新 的 场景 。 





场景 : 显示 买 入 历史 记录 
投资 者 想 看 一 下 特定 股票 的 购买 记录 ， 每 个 记录 要 显示 购买 的 日 期 及 数量 。 


就 现 有 的 实现 而 言 , 这 个 场景 将 了 我 们 一 军 ， 因 为 我 们 没有 跟踪 单 笔 习 入 ， 也 没有 记录 购买 
日 期 。 这 也 是 许多 开发 者 质疑 TDD 的 地 方 。 如 果 多 花 些 时 间 做 一 些 前 期 的 需求 分 析 ， 那么 我 们 就 


会 知道 需要 跟踪 买 人 日 期 。 这 样 的 话 ， 我 们 的 初期 设计 就 可 能 会 纳入 这 个 需求 。 
这 个 场景 所 产生 的 改动 似乎 正好 ，10 多 分 和 




















变 方法 的 参数 列表 、 从 客户 端 代码 提供 日 期 (目前 而 言 ， 仅 仅 是 我 们 的 测试 )、 正 确 地 


结构 ， 并 存储 数据 。 


次 。 我 们 必须 定义 好 表示 买 和 的 数据 结构 、 改 





丰 写 数据 























不 ， 先 不 要 这 样 做 …… 至 少 不 要 一 口气 做 完 。 让 我 们 看 看 能 否 增 量 地 进行 ,每 几 分 钟 就 寻求 

















一 下 正面 的 反馈 。 其 中 一 种 做 法 是 作出 假设 。 主 我 们 先 创建 一 个 做 出 一 笔 买 人 的 测试 ， 然 后 验证 
相应 的 买 人 是 否 在 购买 记录 中 。 假设 买 人 总 是 在 一 个 指定 的 日 期 做 出 , 因为 可 以 不 给 Purchase () 




















传递 日 期 ， 这 使 得 目前 的 任务 更 简单 。 


c6/4/PortfolioTest.cpp 

TEST_F(APortfolio, AnswersThePurchaseRecordForASinglePurchase) { 
portfolio_.Purchase(SAMSUNG, 5); 
auto purchases = portfolio .Purchases(SAMSUNG) ; 


auto purchase = purchases [0] ; 

ASSERT THAT(purchase.ShareCount, Eq(5u)); 

ASSERT THAT(purchase.Date, Eq(Portfolio::FIXED PURCHASE DATE)); 
} 











为 了 让 测试 通过 ， 甚 至 不 需要 将 买 人 记录 和 hotLdings_ 数据 结构 相关 联 。 因 为 目前 的 假设 只 




















考虑 单 次 买 人 ， 所 以 可 以 定义 一 个 “全 局 的 ” 买 人 记录 集合 。 


c6/4/Portfolio.h 


struct PurchaseRecord { 
PurchaseRecord(unsigned int shareCount, const boost::gregorian::date& date) 
: ShareCount(shareCount) 
, Date(date) 1 
} 
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unsigned int ShareCount; 
boost::gregorian::date Date; 


}; 
class Portfolio { 
public: 
> static const boost::gregorian::date FIXED PURCHASE DATE; 


bool IsEmpty() const; 


void Purchase(const std::string& symbol, unsigned int shareCount); 
void Sell(const std::string& symbol, unsigned int shareCount); 


unsigned int ShareCount(const std::string& symbol) const; 


» std::vector«PurchaseRecord» Purchases (const std::string& symbol) const; 
private: 
std::unordered map«std::string, unsigned int» holdings ; 
» std::vector«PurchaseRecord» purchases ; 
}; 


c6/4/Portfolio.cpp 
» const date Portfolio::FIXED PURCHASE DATE(date(2014, Jan, 1)); 


void Portfolio::Purchase(const string& symbol, unsigned int shareCount) ( 
if (0 == shareCount) throw InvalidPurchaseException(); 
holdings [symbol] = shareCount + ShareCount(symbol); 
» purchases .push back(PurchaseRecord(shareCount, FIXED PURCHASE DATE)); 
} 


vector<PurchaseRecord> Portfolio::Purchases(const string& symbol) const { 
return purchases ; 


} 


代码 很 简单 ,但 也 花 了 几 分 钟 才 完 成 ， 每 一 点 改动 都 有 可 能 产生 错误 。 在 继续 














入 代码 的 正面 反馈 是 一 件 很 好 的 事情 。 








前 ,获得 对 


我 们 定义 了 一 个 常量 FIXED_PURCHASE_DATE， 以 便 取得 快速 的 、 可 以 展示 的 进步 。 我 们 知 


首 这 是 假设 的 。 让 我 们 去 掉 这 个 临时 但 有 用 的 假设 吧 ! 





c6/5/PortfolioTest.cpp 
TEST F(APortfolio, AnswersThePurchaseRecordForASinglePurchase) 1 


» date dateOfPurchase(2014, Mar, 17); 
> portfolio .Purchase(SAMSUNG, 5, dateOfPurchase); 


auto purchases = portfolio .Purchases(SAMSUNG) ; 
auto purchase = purchases[0] ; 


ASSERT THAT(purchase.ShareCount, Eq(5u)); 
ASSERT THAT(purchase.Date, Eq(dateOfPurchase)); 
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我 们 不 调用 Purchase() 成 员 函 数 的 其 他 测试 ,而 是 采取 小 步伐 , 使 用 一 个 默认 的 日 期 参数 。 





c6/5/Portfolio.h 


void Purchase( 
const std::string& symbol, 


unsigned int shareCount, 


const boost::gregorian::date& transactionDate- 
» Portfolio::FIXED PURCHASE DATE); 


c6/5/Portfolio.cpp 


» void Portfolio::Purchase( 
» const string& symbol, unsigned int shareCount, const date& transactionDate) ( 
if (0 == shareCount) throw InvalidPurchaseException(); 


holdings [symbol] = shareCount + ShareCount(symbol); 
» purchases .push back(PurchaseRecord(shareCount, transactionDate)); 


} 

因为 使 用 一 个 固定 的 日 期 不 是 有 效 的 长 期 需求 ( 尽管 当前 的 默认 时 间 可 能 是 )， 所 以 我 们 现 
在 想 去 除 Purchase() 的 默认 时 间 。 不 幸 的 是 ， 我 们 还 有 许多 测试 调用 了 没有 传人 日 期 的 
Purchase() 。 

一 种 解决 方案 是 ， 给 所 有 测试 中 受 影响 的 调用 加 一 个 日 期 参数 。 这 似乎 单调 无 味 。 同 时 ， 这 
也 会 违反 测试 抽象 原则 ( 参见 7.4 节 )， 因 为 这 些 测试 不 关心 购买 日 期 。 

需要 一 次 性 改变 很 多 测试 , 且 不 改变 其 行为 的 事实 告诉 我 们 , 这 些 测 试 蕴含 着 必须 去 除 的 重 
复 。 提 供 一 个 fixture 辅 助 方法 , 由 它 来 处 理 对 Purchase( ) 的 调用 并 提供 一 个 默认 日 期 , 这样 测试 
就 不 用 提供 了 ， 这 个 方案 怎么 样 ? 


























c6/6/PortfolioTest.cpp 


class APortfolio: public Test ( 
public: 
static const string IBM; 
static const string SAMSUNG; 
Portfolio portfolio ; 
static const date ArbitraryDate; 


void Purchase( 
const string& symbol, 
unsigned int shareCount, 
const date& transactionDate-APortfolio::ArbitraryDate) { 
portfolio .Purchase(symbol, shareCount, transactionDate); 


) 


YYVYVYYY 


}; 


TEST F(APortfolio, ReducesShareCountOfSymbolOnSell) { 
» Purchase(SAMSUNG, 30); 
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portfolio .Sell(SAMSUNG, 13); 


ASSERT THAT(portfolio .ShareCount(SAMSUNG), Eq(30u - 13)); 
} 


TEST_F(APortfolio, AnswersThePurchaseRecordForASinglePurchase) { 
date date0fPurchase(2014, Mar, 17); 
» Purchase(SAMSUNG, 5, dateOfPurchase); 


auto purchases = portfolio .Purchases(SAMSUNG) ; 


auto purchase = purchases[0] ; 
ASSERT THAT(purchase.ShareCount, Eq(5u)); 
ASSERT THAT(purchase.Date, Eq(dateOfPurchase)); 


} 

一 个 可 能 引起 争议 的 点 是 ， 辅 助 函 数 Purchase( ) 从 测试 中 移 除 了 一 些 信息 一 一 具体 而 言 
ERRAT portfolio 实例 。 第 一 次 阅读 测试 的 人 必须 查看 辅助 函数 以 便 了 解 其 作用 。 但 这 是 
一 个 简单 阴 数 ,没有 隐藏 对 阅读 者 来 说 难以 记忆 的 关键 信息 。 

根据 经 验 ， 不 要 隐藏 事实 (参见 4.2 节 )。 当 需要 让 买 人 操作 成 为 设置 测试 的 一 部 分 时 ， 我 们 
可 以 使 用 辅助 函数 。 但 在 专门 测试 Purchase() 行 为 时 ， 我们 应 该 直接 调用 它 。 因 此 ， 
ReducesShareCountOfSymbolOnSell 可 以 使 用 辅助 函数 ,因为 严 人 操作 是 设置 测试 的 一 部 分 。 因 为 
AnswersShareCountForPurchasedSymbol 是 验证 买 人 行为 的 ， 所 以 其 中 保留 了 对 Purchase() 的 直 
接 调用 。 
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c6/7/PortfolioTest.cpp 


TEST_F(APortfolio, AnswersShareCountForPurchasedSymbol) { 
» portfolio .Purchase(IBM, 2); 
ASSERT THAT(portfolio .ShareCount(IBM), Eq(2u)); 


} 


TEST F(APortfolio, ReducesShareCountOfSymbolOnSell) { 
» Purchase(SAMSUNG, 30); 


portfolio .Sell(SAMSUNG, 13); 
ASSERT THAT(portfolio .ShareCount(SAMSUNG), Eq(30u - 13)); 


} 

就 个 人 而 言 , 我 不 喜欢 这 种 方式 在 测试 中 导致 的 不 一 致 性 ,我 可 以 接受 用 辅助 函数 运行 一 切 ， 
只 要 它 是 一 个 简单 的 单行 委托 ， 就 像 本 例 一 样 。 如 果 这 让 你 感到 困扰 ， 另 一 种 方案 是 ,在 每 个 测 
试 中 包含 一 个 日 期 参数 ， 并 使 用 一 个 名 为 ArbitraryPurchaseDate 的 常量 。 

我 们 一 直 以 非常 小 的 步 又 采取 增 量 方 法 。 这 耗费 时 间 吗 ? 当然 ! 经 常 需 要 引入 少量 的 代码 ， 
然后 再 移 除 一 一 有 一 点 点 浪费 。 


作为 回报 , 我 们 获得 了 更 有 价值 的 能 力 ， 即 能 够 在 创建 设计 良好 、 正 确 的 代码 道路 上 持续 迈 
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进 。 不 用 为 处 理 新 的 、 从 未 考虑 的 功能 而 患得患失 一 一 用 TDD 以 一 系列 小 的 改动 来 开发 它们 。 代 
码 越 是 整洁 ， 越 容易 改动 。 





6.25 更 多 的 重复 
通过 一 系列 的 测试 和 产品 代码 清理 ， 针 对 买 人 记录 的 测试 变 得 简短 上 且 干 净 。 








c6/8/PortfolioTest.cpp 


TEST F(APortfolio, AnswersThePurchaseRecordForASinglePurchase) ( 
Purchase(SAMSUNG, 5, ArbitraryDate); 


auto purchases - portfolio .Purchases(SAMSUNG) ; 
ASSERT PURCHASE(purchases[0], 5, ArbitraryDate); 


TEST F(APortfolio, IncludesSalesInPurchaseRecords) { 
Purchase(SAMSUNG, 10); 
Sell(SAMSUNG, 5, ArbitraryDate); 


auto sales = portfolio .Purchases(SAMSUNG) ; 
ASSERT PURCHASE(sales[1], -5, ArbitraryDate); 
} 


HT SCHEÉUIORS Aduo, RI Sharecount HAARE ER 





c6/8/Portfolio.h 


struct PurchaseRecord { 
» PurchaseRecord(int shareCount, const boost::gregorian::date& date) 
: ShareCount(shareCount) 
, Date(date) {} 
» int ShareCount; 
boost::gregorian::date Date; 


3 


c6/8/PortfolioTest.cpp 
void ASSERT PURCHASE( 
» PurchaseRecord& purchase, int shareCount, const date& date) { 
ASSERT THAT(purchase.ShareCount, Eq(shareCount)); 
ASSERT THAT(purchase.Date, Eq(date)); 


} 
在 产品 代码 中 ， 用 作 交 易 的 Purchase() 和 SetLtL() 函数 中 的 三 行 代码 看 起 来 有 点 密 





c6/8/Portfolio.cpp 


void Portfolio::Purchase( 
const string& symbol, unsigned int shareCount, const date& transactionDate) { 
if (0 == shareCount) throw InvalidPurchaseException(); 
holdings [symbol] = shareCount + ShareCount(symbol); 
purchases .push back(PurchaseRecord(shareCount, transactionDate)); 





void Portfolio::Sell( 
const string& symbol, unsigned int shareCount, const date& transactionDate) ( 
if (shareCount » ShareCount(symbol)) throw InvalidSellException(); 
holdings [symbol] = ShareCount(symbol) - shareCount; 
purchases .push back(PurchaseRecord(-shareCount, transactionDate)); 


) 


再 进一步 来 说 , 它们 本 质 上 很 相似 。 我 们 还 没有 编写 合适 的 逻辑 将 买 人 记录 和 正确 的 股票 
称 对 应 〈 或 许可 以 用 哈 硕 表 )， 也 不 想 重复 编码 。 让 我 们 先 看 看 可 以 去 除 哪些 重复 。 


Purchase () fllSett () 函数 的 这 三 行 代码 差别 不 大 。 证 我 们 逐条 审阅 每 行 代码 , 来 看 看 怎样 
让 它们 相似 。 两 个 函数 中 的 第 一 行 都 是 保护 语句 ， 用 于 执行 一 个 约束 : 卖 出 的 数量 不 能 比 持 有 
的 多 ,不 可 以 买 人 0 股 。 但 是 卖 出 是 不 是 也 应 该 有 相同 的 约束 ， 即 不 能 卖 出 0 股 ? 客户 认为 这 是 
可 以 的 。 


还 有 一 个 小 问题 是 , 在 SetLL() 函数 中 使 用 InvalidPurchaseException 异 常 类 型 的 名 称 是 不 太 合 
适 的 。 我 们 将 它 具 体 化 ， 这 样 两 个 函数 都 可 以 使 用 一 -ShareCountCannotBeZeroException。 
















































































c6/9/PortfolioTest.cpp 


TEST F(APortfolio, ThrowsOnPurchaseOfZeroShares) 1 
ASSERT THROW(Purchase(IBM, 0), ShareCountCannotBeZeroException); 
} 
TE EER 
TEST F(APortfolio, ThrowsOnSellOfZeroShares) { 
ASSERT THROW(Sell(IBM, 0), ShareCountCannotBeZeroException); 
} 


这 样 一 来 ， 两 个 交易 函数 的 保护 语句 就 一 样 了 。 


c6/9/Portfolio.cpp 


void Portfolio::Purchase( 
const string& symbol, unsigned int shareCount, const date& transactionDate) ( 
» if (0 == shareCount) throw ShareCountCannotBeZeroException(); 
holdings [symbol] = shareCount + ShareCount(symbol); 
purchases .push back(PurchaseRecord(shareCount, transactionDate)); 


) 


void Portfolio::Sell( 
const string& symbol, unsigned int shareCount, const date& transactionDate) ( 
if (shareCount » ShareCount(symbol)) throw InvalidSellException(); 
» if (0 == shareCount) throw ShareCountCannotBeZeroException(); 
holdings [symbol] = ShareCount(symbol) - shareCount; 
purchases .push back(PurchaseRecord(-shareCount, transactionDate)); 


) 


继续 看 两 个 函数 中 的 下 一 行 代码 , 通过 加 或 减 已 持 有 的 股票 数 , 可 以 更 新 相应 股票 名 称 的 持 
有 量 。 但 是 减 和 加 上 对 应 负数 的 效果 是 一 样 的 。 
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我 们 引入 一 个 名 为 shareChange 的 有 符号 整数 变量 来 做 到 这 一 点 。 注意 , 也 可 以 在 最 后 一 行 
代码 ( 添加 买 入 记录 的 地 方 ) 中 使 用 它 。 


c6/10/Portfolio.cpp 


void Portfolio::Sell( 
const string& symbol, unsigned int shareCount, const date& transactionDate) { 
if (shareCount » ShareCount(symbol)) throw InvalidSellException(); 
if (0 == shareCount) throw ShareCountCannotBeZeroException(); 
» int shareChange = -shareCount; 
» holdings [symbol] = ShareCount(symbol) + shareChange; 
» purchases .push back(PurchaseRecord(shareChange, transactionDate)); 


} 
现在 再 回头 看 看 Purchase( ) 函数 ， 并 尝试 让 它 看 起 来 更 像 Sell ()。 


c6/11/Portfolio.cpp 


void Portfolio::Purchase( 
const string& symbol, unsigned int shareCount, const date& transactionDate) { 
if (0 == shareCount) throw ShareCountCannotBeZeroException(); 
» int shareChange = shareCount; 
» holdings [symbol] = ShareCount(symbol) + shareChange; 
» purchases .push back(PurchaseRecord(shareChange, transactionDate)); 


H 

现在 ,每 个 函数 的 末尾 两 行 彼此 重复 , 保护 语句 也 是 如 此 。 让 我 们 将 shareChange 变 量 的 初 
始 化 提 到 保护 语句 前 。 虽 然 将 代码 行 移 上 移 下 是 一 件 风险 极 高 的 事 , 但 现 有 的 测试 会 确保 此 改动 
的 安全 性 。 

最 终 得 到 的 每 个 函数 ， 末 尾 三 行 相同 。 同 时 ， 我 们 将 保护 语句 中 使 用 的 shareCount 更 名 为 
shareChange， 这 样 ， 待 提取 出 来 的 三 行 代码 使 用 相同 的 变量 。 





























c6/12/Portfolio.cpp 


void Portfolio::Purchase( 
const string& symbol, unsigned int shareCount, const date& transactionDate) { 
int shareChange - shareCount; 
if (0 == shareChange) throw ShareCountCannotBeZeroException(); 
holdings [symbol] = ShareCount(symbol) + shareChange; 
purchases .push back(PurchaseRecord(shareChange, transactionDate)); 


YvvYvY 


} 


void Portfolio::Sell( 
const string& symbol, unsigned int shareCount, const date& transactionDate) { 
if (shareCount » ShareCount(symbol)) throw InvalidSellException(); 
int shareChange = -shareCount; 
if (0 == shareChange) throw ShareCountCannotBeZeroException(); 
holdings [symbol] = ShareCount(symbol) + shareChange; 
purchases .push back(PurchaseRecord(shareChange, transactionDate)); 


YvYY 


} 
最 后 ， 可 以 提取 了 。 
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c6/13/Portfolio.cpp 
void Portfolio::Purchase( 


const string& symbol, unsigned int shareCount, const date& transactionDate) ( 
Transact(symbol, shareCount, transactionDate); 


) 


void Portfolio::Sell( 
const string& symbol, unsigned int shareCount, const date& transactionDate) ( 
if (shareCount » ShareCount(symbol)) throw InvalidSellException(); 
Transact(symbol, -shareCount, transactionDate); 
j 
void Portfolio::Transact( 
const string& symbol, int shareChange, const date& transactionDate) { 
if (0 == shareChange) throw ShareCountCannotBeZeroException(); 
holdings [symbol] = ShareCount(symbol) + shareChange; 
purchases .push back(PurchaseRecord(shareChange, transactionDate)); 


) 


另外 一 个 和 表达 力 相关 的 寻 
改 成 InsufficientSharesException。 





情 


青 是 ， 异 常 类 型 InvalidSellException 的 名 称 不 是 很 好 。 我 们 将 其 





p 





c6/14/PortfolioTest.cpp 


TEST F(APortfolio, ThrowsWhenSellingMoreSharesThanPurchased) { 
» ASSERT THROW(Sell(SAMSUNG, 1), InsufficientSharesException); 
F 


c6/14/Portfolio.cpp 
void Portfolio::Sell( 


const string& symbol, unsigned int shareCount, const date& transactionDate) { 
» if (shareCount » ShareCount(symbol)) throw InsufficientSharesException(); 
Transact(symbol, -shareCount, transactionDate); 


) 


除了 秉承 两 个 简单 的 设计 规则 外 ， 还 有 什么 可 以 做 得 吗 ? 我 们 似乎 已 经 清除 了 所 有 的 重复 。 
那 可 读 性 呢 ? 除了 委派 工作 ，Purchase() 什 么 都 没 做 ， 因 此 很 清晰 。SetLL() 只 是 简单 地 加 了 一 
个 约束 并 将 股票 数 取 反 ， 所 以 也 比较 清晰 。 但 Transact ( ) 完 全 没有 我 们 想 要 的 即时 性 "。 





6.2.6 ”小 方法 的 好 处 


阅读 Transact() 时 ， 必 须 放 慢 速度 ， 搞 清楚 每 行 代码 到 底 要 完成 什么 。 第 一 行 代 码 会 在 股 
票数 为 0 时 抛 出 异常 。 第 二 行 代 码 获取 相应 股票 的 数量 ， 加 上 股 数 改动 后 ， 再 将 结果 赋值 给 哈 希 
表 中 对 应 的 项 。 第 三 行 代 码 创建 了 一 个 买 人 记录 ， 并 将 其 加 入 到 一 个 总 的 买 人 列表 中 。 


Transact () 困 数 只 包含 三 行 简单 的 代码 。 但 如 果 需 要 仔细 地 阅读 每 行 代码 的 话 ， 那 么 整个 





















































CD 众所周知 ， 股 票 交 易 讲究 即时 性 。 作 者 的 言 下 之 意 是 指 Transact() 实 现 感觉 上 做 了 许多 事 。 这 也 为 下 一 小 节 埋 下 
了 伏笔 。 一 一 译 者 注 
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系统 阅读 起 来 会 更 困难 。 这 不 具 表 达 力 。 我 们 可 以 对 其 进行 修改 。 


c6/15/Portfolio.cpp 


void Portfolio::Transact( 
const string& symbol, int shareChange, const date& transactionDate) ( 
ThrowlIfShareCountIsZero(shareChange); 
UpdateShareCount(symbol, shareChange); 
AddPurchaseRecord(shareChange, transactionDate); 


} 

void Portfolio::ThrowIfShareCountIsZero(int shareChange) const { 
if (0 == shareChange) throw ShareCountCannotBeZeroException(); 

} 


void Portfolio::UpdateShareCount(const string& symbol, int shareChange) { 
holdings [symbol] = ShareCount(symbol) + shareChange; 
} 


void Portfolio::AddPurchaseRecord(int shareChange, const date& date) { 
purchases_.push_back(PurchaseRecord(shareChange, date)); 









































} 
Eis 在 2013 年 年 初创 作 本 章 时 , 我 仿佛 就 能 看 到 许多 读者 的 表情 。 我 
能 感受 到 你 们 的 惊 收 ， 也 能 理解 。 
下 面 可 能 是 你 会 提出 不 这 么 做 的 一 些 理 由 。 cm 
口 这 是 额外 功 。 创 建新 函数 很 费力 。 





a 为 只 在 一 个 地 方 用 到 的 单行 代码 创建 一 个 函数 似乎 很 荒唐 
口 额外 的 函数 调用 会 加 重 性 能 开销 。 

a 很 难 在 所 有 代码 中 遵循 完整 的 控制 流 。 

a 你 会 得 到 成 千 上 万 个 小 方法 ， 且 每 个 方法 都 有 着 巨 长 的 名 称 。 
下 面 是 你 应 该 考虑 这 样 写 代码 的 一 些 原因 。 


这 遵守 了 表达 力 这 一 简单 设计 原则 。 代 码 不 再 需要 解释 性 注释 。 可 以 快速 理解 由 一 行 或 多 行 


o 











语句 构成 的 函数 ， 马 上 看 出 小 函数 出 现 的 问题 。 


相 比 之 下 ,大 多 数 系统 有 很 多 代码 过 长 且 密 集 的 函数 ,让 人 难以 理解 。 这 些 函数 很 容易 藏 





DR 





口 这 遵守 了 内 聚 和 单一 责任 的 设计 原则 。 同 一 函数 中 的 所 有 代码 处 于 同一 层次 的 抽象 。 修 
改 每 个 函数 的 原因 只 有 一 个 。 

a 这 为 以 后 的 设计 改动 铺 平 了 道路 。 我 们 仍然 需要 将 买 人 记录 和 对 应 的 股票 名 称 联系 起 来 ， 
但 现在 可 以 在 一 处 完成 改动 ， 而 非 两 处 。 如 果 需 要 特别 处 理 AddPurchaseRecord() ， 现 
在 就 可 以 做 了 。 如 果 需 要 创建 更 复杂 的 买 人 记录 子 系统 ， 我 们 可 以 快速 地 将 已 有 的 逻辑 
移 到 一 个 新 类 。 如 果 需 要 支持 取消 和 重 做 ,或 围绕 买卖 做 些 其 他 事情 ， 我 们 已 经 准备 好 
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了 以 Transcation 为 基 类 的 命令 模式 。 

口 忽略 具体 的 实现 细节 会 更 容易 理解 代码 控制 流 。Transact() 只 是 一 个 声明 策略 。 其 他 辅助 
函数 ,如 ThrowIfShareCountIsZero()、UpdateShareCount() 和 AddPurchaseRecord()， 
则 是 你 基本 不 需要 知道 的 实现 细节 。 回 忆 一 下 接口 和 实现 或 抽象 和 具体 的 分 离 理 念 。 

口 提取 方法 导致 的 性 能 开销 几乎 不 会 造成 问题 。 参 见 10.2 节 。 

口 小 方法 是 真正 重用 的 开始 。 随 着 越 来 越 多 的 相似 函数 被 提取 出 来 ， 识 别 出 重 复 的 概念 和 
结构 会 变 得 更 加 容易 。 你 不 会 得 到 一 大 堆 不 可 控 的 小 函数 ， 相 反 ， 你 会 大 大 地 缩减 产品 
代码 的 数量 。 


差不多 就 是 这 些 了 。 如 有 果 还 没准 备 好 接受 这 种 风格 的 巨变 ， 那 么 随 着 更 加 深入 地 实践 TDD， 
你 至 少 应 当 为 之 努力 。 多 使 用 小 的 函数 ， 看 看 会 发 生 什么 。 















































6.2.7 ”完成 功能 


我 们 还 没有 完成 。 目 前 的 投资 管理 器 能 够 返回 一 个 买 人 列表 ， 但 只 能 返回 一 支 股 票 的 列表 。 
下 一 个 测试 要 求 投资 管理 器 能 返回 多 支 已 购 股票 的 买 人 记录 。 











c6/16/PortfolioTest.cpp 


bool operator--(const PurchaseRecord& lhs, const PurchaseRecord& rhs) { 
return lhs.ShareCount == rhs.ShareCount && lhs.Date == rhs.Date; 
} 


TEST_F(APortfolio, SeparatesPurchaseRecordsBySymbol) { 
Purchase(SAMSUNG, 5, ArbitraryDate); 
Purchase(IBM, 1, ArbitraryDate); 


auto sales - portfolio .Purchases(SAMSUNG) ; 
ASSERT THAT(sales, ElementsAre(PurchaseRecord(5, ArbitraryDate))); 


) 


Google Mock 提 供 了 ELementsAre() 匹 配器 ， 用 来 验证 指定 的 元 素 是 否 在 集合 中 。 这 一 比较 
需要 比较 两 个 purchaseRecord 对 象 的 能 力 ， 所 以 我 们 添加 了 operator==() 的 正确 实现 。( 也 可 以 
将 opeator( )== 实 现 为 PurchaseRecord 的 成 员 函 数 , 但 目前 我 们 仅 在 测试 中 才 需 要 它 。) 测试 一 开 
始 失败 了 ， 因 为 名 为 purchase 的 向 量 容器 只 包含 两 个 买 人 记录 E 


一 个 是 Samsung， 男 一 个 是 
IBM。 


为 了 让 测试 通过 , 我 们 先 在 PortfoLio.h 中 定义 成 员 变量 purchaseRecord , 这 是 一 个 无 序 
映射 容器 ， 为 每 支 股票 保存 了 一 个 包含 了 此 股票 买 人 记录 的 向 量 容器 。 同 时 ， 我 们 修改 
AddPurchaseRecord() 函数 ， 使 其 接受 一 支 股票 作为 参数 。 






































c6/16/Portfolio.h 
class Portfolio { 
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public: 

bool IsEmpty() const; 
void Purchase( 

const std::string& symbol, 

unsigned int shareCount, 

const boost::gregorian::date& transactionDate); 
void Sell(const std::string& symbol, 

unsigned int shareCount, 

const boost::gregorian::date& transactionDate); 
unsigned int ShareCount(const std::string& symbol) const; 
std::vector«PurchaseRecord» Purchases(const std::string& symbol) const; 


private: 
void Transact(const std::string& symbol, 
int shareChange, 
const boost::gregorian::date&); 
void UpdateShareCount(const std::string& symbol, int shareChange); 


» void AddPurchaseRecord( 

» const std::string& symbol, 

» int shareCount, 

» const boost::gregorian::date&); 
void ThrowIfShareCountIsZero(int shareChange) const; 
std::unordered map«std::string, unsigned int» holdings ; 
std::vector«PurchaseRecord» purchases ; 

» std::unordered map«std::string, std::vector«PurchaseRecord»» purchaseRecords ; 

}; 





相应 地 ， 我 们 也 更 新 了 Transact() 的 实现 ， 将 股票 名 传 给 AddPurchaseRecord() 。 在 
AddPurchaseRecord() 中 ,通过 加 入 新 的 代码 ， 将 PurchaseRecord 添 加 进 purchaseRecords_ 
中 ( 如果 需要 的 话 ， 先 添加 一 个 空 的 向 量 容器 )。 保 持 已 有 的 逻辑 不 变 一 一 在 整理 旧 代 码 前 ， 先 
让 新 的 代码 如 期 工作 。 








c6/16/Portfolio.cpp 


void Portfolio::Transact( 
const string& symbol, int shareChange, const date& transactionDate) ( 
ThrowlIfShareCountIsZero(shareChange); 
UpdateShareCount(symbol, shareChange); 
» AddPurchaseRecord(symbol, shareChange, transactionDate); 


} 


void Portfolio::AddPurchaseRecord( 
const string& symbol, int shareChange, const date& date) { 
purchases .push back(PurchaseRecord(shareChange, date)); 
auto it = purchaseRecords .find(symbol); 
if (it == purchaseRecords .end()) 
purchaseRecords [symbol] = vector«PurchaseRecord»(); 
purchaseRecords [symbol].push back(PurchaseRecord(shareChange, date)); 


vYYYN 


} 


unsigned int Portfolio::ShareCount(const string& symbol) const { 
auto it = holdings_.find(symbol); 
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不 有 


if (it == holdings .end()) return 0; 
return it-»second; 


} 


vector<PurchaseRecord> Portfolio::Purchases(const string& symbol) const { 
> // 返回 purchases ; 
» return purchaseRecords .find(symbol)-»second; 


} 





Purchases () KAUP, WIERE AR IRURE EISE A R I8] 


量 容器 。 我 们 只 写 适 量 的 代码 ， 


上 担心 能 不 能 找到 股票 。 相 比 于 担心 ,我 们 在 测试 列表 中 加 入 一 个 条 目 〈 ”处 理 在 买 人 记录 中 





找 不 到 特定 股票 的 情况 ”)。 


一 旦 所 有 测试 通过 ,就 可 以 通过 移 除 对 purchase 的 引用 来 整理 代码 。 编写 刚 刚 加 入 测试 列 
表 的 测试 。 我 们 先进 一 步 整 理 一 下 代码 。 从 表达 力 角 度 来 看 ，AddPurchaseRecord() 显 得 有 点 
扒 徐 。 从 重复 代码 角度 来 看 ，ShareCount() 和 Purchases() 中 都 包含 了 在 映射 容器 中 查找 元 素 
的 代码 。 我 们 先 处 理 这 两 个 问题 。 























c6/17/PortfolioTest.cpp 




















TEST F(APortfolio, AnswersEmptyPurchaseRecordVectorWhenSymbolNotFound) { 
ASSERT THAT(portfolio .Purchases(SAMSUNG), Eq(vector«PurchaseRecord»())); 


} 


c6/17/Portfolio.h 


template«typename T> 


T Find(std::unordered map«std::string, T> map, const std::string& key) const ( 


auto it - map.find(key); 
return it == map.end() ? T() : it-»second; 


c6/17/Portfolio.cpp 


#include "Portfolio.h" 

#include "PurchaseRecord.h" 

using namespace std; 

using namespace boost::gregorian; 


bool Portfolio::IsEmpty() const { 
return 0 == holdings .size(); 


} 


void Portfolio: :Purchase( 
const string& symbol, 
unsigned int shareCount, 
const date& transactionDate) { 
Transact(symbol, shareCount, transactionDate); 


) 


void Portfolio::Sell( 
const string& symbol, 
unsigned int shareCount, 
const date& transactionDate) { 
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if (shareCount > ShareCount(symbol)) throw InvalidSellException(); 
Transact(symbol, -shareCount, transactionDate); 


} 


void Portfolio::Transact( 
const string& symbol, int shareChange, const date& transactionDate) { 
ThrowIfShareCountIsZero(shareChange); 
UpdateShareCount (symbol, shareChange); 
AddPurchaseRecord(symbol, shareChange, transactionDate); 


} 


void Portfolio::ThrowIfShareCountIsZero(int shareChange) const { 
if (0 == shareChange) throw ShareCountCannotBeZeroException(); 


} 


void Portfolio::UpdateShareCount(const string& symbol, int shareChange) { 
holdings [symbol] = ShareCount(symbol) + shareChange; 
} 


void Portfolio::AddPurchaseRecord( 
const string& symbol, int shareChange, const date& date) { 
if (!ContainsSymbol(symbol)) 
InitializePurchaseRecords (symbol); 
Add(symbol, [(shareChange, date]); 
} 


void Portfolio::InitializePurchaseRecords(const string& symbol) { 
purchaseRecords_[symbol] = vector<PurchaseRecord>(); 





} 
void Portfolio::Add(const string& symbol, PurchaseRecord&& record) { 
purchaseRecords [symbol].push back(record); 


} 


bool Portfolio::ContainsSymbol(const string& symbol) const { 
return purchaseRecords .find(symbol) != purchaseRecords .end(); 


} 


unsigned int Portfolio::ShareCount(const string& symbol) const { 
return Find«unsigned int»(holdings , symbol); 


} 


vector<PurchaseRecord> Portfolio::Purchases(const string& symbol) const { 
return Find«vector«PurchaseRecord»»(purchaseRecords , symbol); 


} 


好 吧 ， 我 们 整理 了 不 只 “一 点 点 ”， 难 道 不 是 吗 ? 我 们 再 一 次 做 了 大 量 的 小 函数 重 构 。 现 在 
AddPurchaseRecord() 声 明了 高 层次 的 策略 ， 其 中 的 三 个 函数 代表 了 策略 中 封装 了 实现 细节 的 
每 个 步 又。 过 度 编码 ? 或 许 吧 ! 优势 呢 ? 可 以 立刻 理解 代码 ， 这 是 肯定 的 。 同 时 ， 实 现 细节 的 分 
离 意味 着 ， 如 果 想 要 使 用 不 同 的 数据 结构 ,需要 改动 的 地 方 将 会 一 目 了 然 且 相对 独立 ,因此 降低 
了 风险 。 此 外 ， 由 于 对 合适 的 成 员 函 数 使 用 了 const ， 我 们 也 可 以 清楚 地 知道 修改 了 Portfolio 状 
态 的 每 个 步 又 。 
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最 后 ,我 们 也 做 好 了 迈 向 更 好 设计 的 准备 。 在 下 一 节 中 , 买 人 记录 的 集合 最 终 自 成 一 体 , 成 
为 一 个 独立 的 类 。 目 前 ， 对 所 有 基于 此 集合 操作 的 整理 为 切换 到 新 的 设计 提供 了 方法 。 

要 说 明 的 是 ,我 们 并 没有 提前 思考 设计 。 相 反 ,， 我 们 先 得 到 了 一 个 可 以 运行 的 代码 ， 然 后 再 
优化 现 有 方案 的 设计 。 这 样 做 的 副作用 是 ， 以 后 的 改动 会 更 加 容易 。 





X 



































6.2.8 增 量 设计 让 事情 变 得 简单 

Portfolio 中 有 两 个 很 相似 的 集合 : holdings_ 和 purchaseRecords ,前 者 将 股票 和 总 股 数 相 
联系 ， 后 者 将 股票 和 购买 记录 相 联系 。 可 以 去 除 hoLdings_， 转 而 按照 需要 来 计算 一 个 特定 股票 
的 股 数 。 

保持 两 个 集合 是 一 种 性 能 优化 。 这样 导致 代码 稍 显 复 杂 , 我 们 需要 保证 这 两 个 集合 总 是 保持 
一 致 。 这 最 终 还 是 由 你 决定 的 。 如 果 你 认为 性 能 优先 ,那么 可 以 保持 代码 不 变 。 因 为 目前 不 需要 
考虑 性 能 ， 所 以 先 找 出 共同 的 代码 。 

第 一 步 是 改变 ShareCount ( ) ， 使 其 能 够 动态 地 计算 出 特定 股票 的 股 数 。 





















































c6/18/Portfolio.cpp 


unsigned int Portfolio::ShareCount(const string& symbol) const ( 
auto records = Find«vector«PurchaseRecord»»(purchaseRecords , symbol); 
return accumulate(records.begin(), records.end(), 0, 
[] (int total, PurchaseRecord record) ( 
return total + record.ShareCount; }); 


H 

我 们 不 需要 在 Transact() 中 调用 UpdateshareCount () 了 。 可 以 安全 地 删除 UpdateShare- 
Count() 了 ! 然后 修改 IsEmpty() ， 使 其 指向 purchaseRecords 而 非 holdings ， 这 样 我 们 终 
于 可 以 删除 hoLdings 了 。 











c6/18/Portfolio.cpp 


bool Portfolio::IsEmpty() const { 
» return 0 == purchaseRecords .size(); 


} 


void Portfolio::Transact( 
const string& symbol, int shareChange, const date& transactionDate) { 
ThrowlfShareCountIsZero(shareChange); 
AddPurchaseRecord(symbol, shareChange, transactionDate); 


) 

整个 过 程 十 分 简单 。 

最 后 要 做 的 是 , 将 所 有 和 买 和 记录 相关 的 代码 抽出 来 , 单独 创建 一 个 类 。 为 什么 呢 ? Portfolio 
类 违反 了 单一 责任 原则 。 修 改 Portfolio 类 的 主要 原因 应 该 和 操作 股票 的 方式 有 关 。 但 还 有 一 个 需 
要 修改 的 原因 一 一 针对 买 和 人 记录 的 特定 实现 细节 。 
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那 又 怎样 呢 ? 我们 只 是 改动 了 设计 来 简化 代码 , 但 是 这 个 改动 可 能 也 象征 着 不 可 接受 的 性 有 
退化 。 将 买 入 记录 代码 独立 出 来 遵循 了 单一 责任 原则 的 设计 , 让 我 们 可 以 更 容易 地 找到 需要 性 色 
优化 的 点 。 提 取代 码 可 以 降低 不 小 心 破坏 Portfolio 功 能 的 概率 。 

我 们 可 以 再 一 次 增 量 地 改动 代码 、 添 加 一 些 新 代码 、 运 行 测试 以 确保 所 有 的 功能 依然 有 效 。 
首先 , 引入 一 个 新 的 成 员 变 量 , 从 而 将 股票 和 持 有 量 联系 起 来 。 可 以 将 之 命名 为 hnoLdings OR, 
听 着 很 耳 熟 啊 ! )。 





























c6/19/Portfoilo.h 
> std::unordered map<std::string, Holding» holdings ; 


然后 ， 逐 步 加 入 支持 来 更 新 holdings , "5A initializePurchaseRecords ( ) JF Af. 


6/19/Portfolio.cpp 


void Portfolio::InitializePurchaseRecords(const string& symbol) { 
purchaseRecords [symbol] = vector«PurchaseRecord»(); 
» holdings [symbol] - Holding(); 
} 


在 Add( ) 函数 中 ， 将 功能 委托 给 Holding 类 中 的 一 个 同名 函数 。 从 Portfolio 类 中 复制 代码 到 
Holding 类 ， 并 适当 简化 。 








c6/19/Portfolio.cpp 


void Portfolio::Add(const string& symbol, PurchaseRecord&& record) ( 
purchaseRecords [symbol].push back(record); 
» holdings [symbol].Add(record); 
} 


c6/19/Holding.h 


void Add(PurchaseRecord& record) ( 
purchaseRecords .push back(record); 


} 


std::vector«PurchaseRecord» purchaseRecords ; 


现在 轮 到 Purchases () 函数 了 。 用 一 个 更 简单 的 版 本 替代 现 有 的 代码 ( 先 注释 掉 
心 ， 这 些 被 注释 的 代码 不 会 一 直 这 样 的 )， 将 功能 也 委托 给 Holding 类 中 的 一 个 新 函数 。 





不 要 担 











c6/19/Portfolio.cpp 

vector«PurchaseRecord» Portfolio::Purchases(const string& symbol) const { 

// return Find«vector«PurchaseRecord»»(purchaseRecords , symbol); 
return Find«Holding»(holdings , symbol).Purchases(); 


} 


c6/19/Holding.h 


std::vector«PurchaseRecord» Purchases() const { 
return purchaseRecords ; 


} 
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就 像 之 前 的 purchaseRecords , Xfholdings 做 相同 的 操作 可 以 更 新 ContainsSymbol()。 


c6/19/Portfolio.cpp 


bool Portfolio::ContainsSymbol(const string& symbol) const { 

// return purchaseRecords .find(symbol) !- purchaseRecords .end(); 
return holdings .find(symbol) !- holdings .end(); 

} 


修改 ShareCount () 是 另 一 种 委派 。 

















c6/19/Portfolio.cpp 


unsigned int Portfolio::ShareCount(const string& symbol) const ( 
// auto records - Find«vector«PurchaseRecord»»(purchaseRecords , symbol); 
// return accumulate(records.begin(), records.end(), 0, 
// [1] (int total, PurchaseRecord record) 1 
// return total + record.ShareCount; )); 
return Find«Holding»(holdings , symbol).ShareCount(); 
} 


c6/19/Holding.h 


unsigned int ShareCount() const ( 
return accumulate(purchaseRecords .begin(), purchaseRecords .end(), 6, 
[] (int total, PurchaseRecord record) { 
return total + record.ShareCount; }); 


} 


最 后 , 我 们 尝试 移 除 成 员 变量 purchaseRecords_。 编译 器 会 指出 哪些 代码 仍 在 引用 此 变量 。 
删 掉 这 些 引 用 并 确保 测试 依然 通过 。( 确实 通过 了 1! ) 























c6/19/Portfolio.h 

// 不 再 需要 了 | 

std::unordered map<std::string, std::vector<PurchaseRecord>> purchaseRecords ; 

差不多 大 功 告 成 了 。 最 后 的 工作 是 确保 为 Holding 类 创建 了 测试 。 代 码 已 经 在 Portfolio 的 上 下 
文中 测试 过 了 , 为 什么 还 要 添加 测试 呢 ? 原因 是 我 们 也 想 保留 测试 提供 的 文档 价值 。 如 果 想 使 用 
Holding 类 ， 开 发 者 可 以 通过 阅读 测试 (记录 了 它 的 行为 ) 来 了 解 怎么 使 用 。 

当 以 此 方式 提取 新 类 时 ， 有 了 时 可 以 将 测试 直接 转移 ( 例如 ， 从 PortfolioTest 到 HoldingTest )。 
通常 而 言 ， 测 试 也 会 变 得 简单 ， 这 时 可 能 要 考虑 重新 为 它们 起 个 名 字 。( 可 以 看 看 下 载 的 源 代码 
中 的 最 后 测试 )。 

最 后 的 结果 是 Holding 类 中 的 代码 极其 简单 ， 每 个 函数 只 有 一 行 , 很 容易 理解 。Portfolio 类 中 
的 代码 也 相当 简单 ， 函 数 也 都 只 有 一 两 行 ， 也 很 容易 理解 。 

贯穿 在 整个 过 程 中 的 另 一 件 美妙 事情 是 , 我 们 可 以 对 设计 一 步 步 地 做 出 大 的 改动 , 不 需要 有 
太 多 顾虑 。 坦 率 地 说 ， 在 为 本 书 编写 这 个 示例 时 ,我 至 少 犯 了 一 个 不 易 察觉 的 错误 ， 好 在 测试 立 
刻 让 我 明白 错 在 哪 了 。 
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至 于 性 能 ， 恢 复 到 最 初 的 性 能 还 是 简单 直接 的 。 如 果 需 要 ， 我 们 可 以 将 股票 总 数 缓存 在 
Holding 类 的 一 个 成 员 变量 中 ， 每 次 调用 Add ( ) 时 就 将 数量 累加 到 这 个 变量 ， 用 ShareCount() 直 
接 返 回 这 个 变量 的 值 。 











6.3 预先 设计 在 哪 


如 果 是 在 20 世 纪 90 年 代 编写 代码 的 话 ， 你 的 团队 必定 会 做 大 量 的 前 期 工作 来 完成 设计 模型 。 
可 能 要 研究 用 例 来 理解 需求 , 接 下 来 要 创建 类 图 、 状 态 模型 、 顺 序 图 、 协 作 图 、 组 件 模 型 ,等 等 。 

如 今 ， 你 可 能 很 少 会 创建 此 类 模型 。 敏 捷 方 法 的 关注 点 使 开发 团队 抛弃 了 详细 的 设计 模型 。 
“敏捷 方法 认为 我 们 不 需要 设计 ”， 至 少 我 听 说 过 这 句 话 。 

那么 敏捷 中 所 说 的 设计 是 什么 呢 ? 敏捷 原则 〈 敏捷 宣言 的 一 部 分 ， 参 见 http:Vagilemanifesto. 
org/principles.html ) 声明 ， 软 件 必须 对 客户 有 用 ， 能 够 在 任何 时 候 适 应 变化 的 需求 ， 同 时 必须 具 
备 可 以 工作 、 拥 有 好 的 设计 、 不 包含 没 必要 的 复杂 度 等 特性 。 此 原则 中 没有 对 “好 ”的 定义 , 也 
没 提 到 什么 时 候 设计 。 

敏捷 的 挑战 在 于 要 能 应 对 变化 。 壁 如 , 一 个 新 的 功能 需求 出 现 了 , 但 这 个 功能 你 从 来 没 想到 
过 ， 现 在 你 必须 想 出 怎样 将 此 功能 加 入 到 并 没有 为 适应 此 功能 而 设计 的 系统 中 。 


假设 你 花费 了 大 量 的 时 间 来 决定 整个 新 系统 必须 要 做 什么 。 得 出 了 相应 设计 模型 的 完美 集合 
后 , 开始 构建 系统 。 因 为 没有 花 时 间 做 TDD， 所 以 你 的 团队 进展 很 快 (至少 他 们 是 这 么 认为 的 )。 
分 析 、 设 计 和 实现 的 每 个 步 又 各 花 两 个 月 ， 这 意味 着 六 个 月 之 后 ， 你 就 可 以 发 布 系统 了 。 


此 后 冒 出 的 任何 新 需求 没有 体现 在 你 的 全 面 预先 设计 中 。 有 时 这 没什么 问题 , 但 是 大 部 分 时 
候 却 不 是 如 此 ,这 时 系统 开发 的 速度 开始 减 慢 。 你 能 够 简单 地 处 理 一 些 新 的 功能 需求 , 但 是 很 多 
其 他 改动 很 难 实现 。 有 些 改动 需要 令 人 厌烦 的 特殊 处 理 ， 因 为 系统 设计 并 没有 考虑 它们 。 许 多 新 
功能 需要 在 系统 范围 内 做 大 量 改动 。 分 析 系 统 、 得 出 怎样 进行 这 些 改动 所 花费 的 时 间 也 在 增加 。 


随 着 系统 中 的 依赖 结构 退化 , 开发 的 速度 会 持续 变 慢 。 当 新 的 改动 引入 难于 修复 且 看 似 不 相 
干 的 缺陷 时 ,团队 的 进度 会 进一步 变 慢 。 此 时 你 会 希望 用 快速 单元 测试 的 方式 来 更 好 地 驾驭 系统 。 


然而 ,即使 知道 系统 必须 要 做 什么 , 勾勒 出 最 初 的 设计 还 是 有 价值 的 。 但 没 必要 在 初始 设计 
的 细节 方面 做 到 巨细 无 遗 。 要 关注 高 层 结构 : 哪些 是 系统 中 的 关键 类 和 依赖 关系 ? 子 系统 之 间 以 
及 对 外 的 接口 有 哪些 ”核心 消息 流 又 有 哪些 ”你 可 以 只 花费 两 个 月 的 零头 来 起 草 一 份 良 好 的 高 
层 结构 和 初始 设计 ， 不 这 样 做 则 需要 多 花费 两 个 月 时 间 。 

TDD 是 处 理 设计 的 一 种 方法 , 具有 持续 性 。 好比 把 初始 设计 期 间 节 省 下 来 的 时 间 分 摊 到 整个 
产品 周期 中 。 研 究 〈 参 见 11.2 节 ) 表明 ，TDD 在 项 目 伊 始 时 会 耗费 多 一 点 的 开发 精力 ， 但 产 出 的 
代码 是 高 质量 的 。 这 些 研究 没有 讨论 最 小 化 预先 设计 节省 的 时 间 。 
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当然 ,可 以 在 预先 设计 期 投入 大 量 精力 , 但 要 接受 所 得 出 的 模型 几乎 总 是 错 的 。 一 旦 开始 编 
码 , 许多 变化 就 会 出 现 : 客户 改变 了 主意 、 市 场 发 生 了 变化 、 你 学 到 了 更 多 东西 并 发 现 了 更 好 的 
设计 方法 ， 或 者 某 人 意识 到 漏 掉 了 一 些 需求 或 有 些 需求 错 了 。 


预先 设计 是 一 个 很 好 的 起 始 路 线 图 。 围 绕 此 设计 的 讨论 有 助 于 发 现 软件 中 必须 要 做 的 东西 ， 
以 及 最 初 该 怎样 设计 软件 。 但 是, 打造 系统 所 需要 的 大 量 细 节 会 发 生变 化 。 例 如 ， 类 图 是 一 个 需 
要 创建 的 好 东西 , 但 不 要 过 度 执 着 于 底层 细节 : 私有 还 是 公开 , 属性 细节 ,聚合 还 是 组 合 , 等 等 。 
这 些 东 西 来 源 于 测试 驱动 的 过 程 。 相 反 ， 应 致力 于 类 名 、 依 赖 关 系 ， 或 一 些 关 键 的 公共 行为 。 

TDD 人 允许 你 基于 当前 的 业务 需求 ， 保 持 一 个 可 能 的 最 简 设 计 。 如 果 一 直 保 持 设 计 尽 量 简洁 ， 
那么 就 可 以 最 大 可 能 地 引入 新 的 、 从 未 被 考虑 过 的 功能 。 相 反 ， 如 果 任 由 系统 退化 (并 有 大 量 的 
重复 代码 和 星 涩 难 懂 的 代码 )， 未 来 有 任何 新 的 需求 时 ， 你 将 痛苦 万 分 。 












































6.3.1 哪里 才 会 讨论 真正 的 设计 呢 


我 们 在 前 文中 就 讨论 了 真正 的 设计 。 可 以 重读 一 下 Portfolio 示 例 。 诚 然 ， 这 只 是 应 用 程序 的 
一 个 简单 部 分 ， 但 是 其 中 所 用 的 理念 却 适 用 于 超大 型 系统 。 


“不 ， 我 的 意思 是 ， 哪 里 讨论 了 耦合 、 内 聚 、 单 一 责任 原则 、SOLID 设 计 原 则 、 依 赖 结 构 、 
代码 坏 味 、 迪 米 特 法 则 ”、 模 式 、 封 装 、 组 合 还 是 继承 ， 等 等 ? ” 问 得 好 。 首 先 ， 本 书 不 是 一 本 
讨论 经 典 面 向 对 象 设计 概念 的 图 书 。 本 书 讨论 的 是 测试 驱动 开发 , 本 章 的 目标 是 向 你 展示 怎样 增 
量 地 处 理 持续 进化 的 设计 。 


其 次 ,你 真 的 需要 知道 所 有 的 经 典 设计 理念 。 同 时 也 要 一 直 寻 求 更 多 关于 设计 的 知识 。 只 要 
能 比较 容易 地 增 量 改动 就 还 好 。 如 果 目 前 还 不 知道 这 些 设计 理念 , 不 要 担心 。 简 单 的 设计 理念 "将 
让 你 抵达 设计 殿堂 。 但 要 继续 深入 学 习 。 

当 处 于 TDD 的 重 构 阶段 , 你 要 尽 可 能 地 了 解 与 优秀 设计 构成 相关 的 所 有 知识 。 同 时 ,也 要 尽 
可 能 地 了 解 团队 的 想法 。 你 是 在 一 个 共享 的 代码 库 中 工作 , 需要 与 团队 就 哪些 可 接受 、 哪 些 与 设 
计 无 关 等 方面 达成 共识 。 

大 多 数 时 候 , 经 典 设计 理念 和 简单 设计 原则 相 一 致 。 举 个 例子 ,设计 模式 主要 与 解决 方案 的 
表达 力 相 关 。 像 模板 方法 这 样 的 模式 主要 用 于 消除 重复 。 




















































































































(D 迪 米 特 法 则 是 Ian Holland 在 美国 东北 大 学 做 Demeter 项 目 时 提出 的 ， 此 法 则 命名 也 是 来 源 于 此 项 目 。 此 规则 的 目的 
是 通过 简单 的 方法 减少 系统 中 对 象 间 的 行为 耦合 ， 每 个 对 象 尽 量 减 少 与 其 他 对 象 的 直接 交互 行为 。 此 规则 后 来 被 
许多 工业 系统 所 采用 ,包括 NASA 的 火星 探 路 者 飞行 器 系统 。 译 者 注 
D 简单 的 设计 理念 在 Unix 程 序 设 计 文化 中 被 奉 为 在 泉 ， 即 常 说 的 K.ILS.S (Keep itsimple, stupid ) 原则 。 和 模式 一 样 ， 
此 原则 来 自 于 计算 机 外 的 工程 领域 。 由 美国 航空 系统 工程 师 Kelly Jonhson 首 次 提出 。 译 者 注 
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6.3.2 简单 设计 原则 和 经 典 设计 理念 会 在 哪 起 冲突 


在 一 些 情况 下 ， 你 应 该 以 现代 、 增 量 的 设计 理念 取代 经 典 〈 又 称 为 旧 的 ) 的 设计 理念 。 下 面 
列 出 了 老 派 设 计 和 TDD 中 的 增 量 设计 相 冲 突 的 一 些 地 方 。 

a 访问 性 : 仍然 应 当 尽 量 保持 成 员 私 有 化 。 这 会 使 得 有 些 改动 变 得 更 容易 些 〈 例 如 ， 安 全 
地 重 命名 一 个 公有 成 员 函 数 所 需要 的 工作 量 比重 命名 一 个 私有 函数 要 多 )。 虽 然 不 太 可 
能 ， 但 暴露 不 必要 的 成 员 会 使 得 系统 受到 恶意 或 糊涂 客户 的 破坏 。 
但 是 ， 如 果 你 需要 放松 访问 控制 来 让 测试 验证 一 些 功能 是 否 可 以 如 期 工作 ， 那 大 多 数 时 
间 就 不 要 为 此 担心 了 。 如 果 每 样 东西 都 被 测试 ， 那 么 测试 就 会 保护 系统 免 受 糊涂 客户 的 
破坏 。 知 道 系统 可 以 如 期 工作 远 比 对 未 来 滥用 的 杞 人 忧 天 更 让 人 向 往 。 如 果 你 依然 感到 
担忧 ， 也 有 比较 聪明 且 安 全 的 方法 。 但 记 住 ， 聪 明和 思春 往往 只 是 一 念 之 差 。 
在 测试 中 ， 绝 对 要 避免 不 必要 的 设计 ， 例 如 ， 用 私有 还 是 公有 控制 。 没 有 人 会 调用 你 的 
测试 ， 测 试 中 的 访问 指示 符 只 会 影响 可 读 性 。 
及 时 性 : 老 派 的 设计 希望 你 能 尝试 获得 尽 可 能 完美 的 设计 。 在 简单 设计 中 ， 这 是 不 正确 
的 。 实 际 上 ， 越 是 绞 尽 脑汁 想 出 应 对 未 来 每 种 可 能 功能 的 设计 ， 就 越 会 付出 更 多 时 间 ， 
同时 ， 当 功能 需求 真 的 出 现时 ， 你 依然 需要 做 大 量 的 修改 。 最 好 的 方式 是 ， 学 习 怎 样 通 
过 简单 、 增 量 的 设计 来 持续 地 应 对 变化 。 
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6.4 阻碍 重 构 的 因素 


梯 承 将 简单 、 增 量 的 设计 理念 作为 主要 的 设计 驱动 力 的 原则 , 重 构 环节 是 完成 很 多 真正 的 工 
作 的 地 方 。 任 何 阻碍 你 方便 地 重 构 ， 甚 至 打消 重 构想 法 的 因素 都 是 不 好 的 ， 可 以 说 是 糟糕 的 。 
且 停 止 增 量 地 重 构 ， 系 统 就 会 迅速 地 退化 。 


当心 以 下 阻碍 重 构 的 因素 。 


Q 测试 不 足 : 使 用 TDD 的 话 ， 构 建 进 系统 的 每 一 小 块 逻辑 都 有 对 应 的 快速 测试 。 这 些 测试 
可 以 给 予 你 充足 的 信心 来 构建 更 好 的 人 代码。 相反， 如 果 你 只 有 少量 的 快速 单元 测试 ， 随 
之 而 来 的 是 更 低 的 测试 覆盖 率 ， 重 构 的 热情 和 重 构 的 能 力 会 大 大 缩减 。 开 发 代码 的 方法 
也 会 趋 于 保守 :“ 如 果 没 有 故障 ， 那 就 不 用 改动 !” 例 如 ， 你 明知 道 将 相同 的 代码 改 为 一 
个 辅助 函数 是 好 事 , 但 是 你 不 做 ， 因 为 这 些 改 动 会 涉及 别人 的 代码 ， 而 这 些 代码 已 经 可 
LL TAE, 

口 生存 周期 长 的 分 支 : 如 果 曾 经 合并 过 包含 大 量 改动 的 其 他 分 支 中 的 代码 ， 那 么 你 应 该 知 
道 大 量 的 重 构 会 使 合并 代码 异常 困难 。 在 一 个 分 支 上 工作 的 开发 者 或 许 会 被 要 求 最 小 化 
改动 范围 。 这 样 做 可 能 会 使 代码 合并 更 简单 些 ,但 也 会 使 代码 库 从 此 深 受 前 熬 "。 如 果 必 









































































































































D 大 量 的 小 改动 会 使 代码 库 的 代码 提交 增加 ， 虽 然 多 点 ,但 小 的 改动 更 符合 TDD 风 格 。 一 一 译 者 注 
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须 在 长 时 间 内 维持 多 个 分 支 ， 那 么 你 可 以 持续 地 从 主线 中 合并 代码 。 和 否则 ， 避 免 生存 周 
期 长 的 分 支 。 

a 与 实现 相关 的 测试 : 在 测试 驱动 开发 中 ， 类 的 行为 是 通过 其 公有 接口 来 展现 的 。 按 定义 
来 说 ， 重 构 是 在 不 改变 其 外 在 公有 行为 的 前 提 下 改变 设计 的 。 如 果 测 试 知道 内 部 私有 实 
现 细 布 的 话 ， 那 么 在 这 些 私 有 细节 改变 时 ， 测 试 就 有 失败 的 可 能 。 你 要 能 够 按 需 地 改变 
底层 代码 结构 ， 自 由 地 提取 或 内 联 方法 。 


大 量 的 模拟 或 协作 者 存根 会 向 测试 暴露 一 些 本 该 私有 的 细节 。 使 用 得 当 的 话 ， 使 用 测试 
替身 不 会 导致 问题 。 但 如 果 随 意 使 用 ， 你 可 能 会 在 重 构 时 发 现 许 多 测试 失败 。 这 也 是 很 
多 开发 者 不 愿意 重 构 的 好 借口 。 


大 量 的 技术 债务 : 大 量 星 涩 难 懂 的 代码 足以 让 许多 开发 者 放弃 重 构 。“ 我 该 从 哪 下 手 呢 ?”” 
越 是 任 由 代码 退化 ， 越 是 难以 对 它 做 出 改变 。 一 定 要 确保 始终 好 好 利用 重 构 环节 。 

缺乏 知识 : 任何 你 不 知道 的 事情 都 能 够 且 终 将 绊 倒 你 。 或 许 你 对 设计 略 知 一 二 ， 在 本 章 
中 也 学 习 了 简单 设计 原则 ， 但 还 是 再 多 学 点 吧 ! 如 果 在 设计 方面 没有 夯实 基础 ， 你 的 重 
构 就 很 可 能 不 够 充分 。 
着 迷 于 提前 的 性 能 优化 : 本 书 中 所 提倡 的 许多 观点 都 是 基于 小 的 类 和 函数 ， 它 们 会 带 来 
创建 额外 对 象 、 调 用 额外 函数 的 开销 。 许 多 开发 者 对 此 有 点 抵触 ， 并 满意 于 过 长 的 函数 
和 类 。 

确保 先 创建 一 个 整洁 、 可 维护 的 设计 。 得 到 一 个 适合 设计 的 性 能 数据 来 判断 它 是 否 有 性 
能 缺陷 。 仅 对 必须 优化 的 代码 进行 优化 。 大 多 数 优化 会 增加 理解 和 维护 代码 的 难度 。 
绩效 考核 : 如 果 公 司 崇 尚 绩效 或 将 一 大 笔 钱 ( 以 工资 或 奖金 的 方式 ) 与 特定 的 指标 绑 定 ， 
那么 聪明 的 员工 会 竭尽 所 能 地 完成 指标 。 如 果 指 标 是 以 一 个 数字 度量 的 ， 那 么 精明 的 开 
发 者 会 寻找 达到 这 一 数字 的 最 优 方法 ， 而 不 管 其 所 做 所 为 是 否 是 真正 业务 所 需要 的 。 
例如 , 将 缺陷 密度 值 定义 为 每 一 千 行 代码 的 缺陷 数目 (kilo lines ofcode, KLOC )。( 注意 ， 
你 也 可 以 将 缺陷 密度 看 作 每 个 功能 点 "有 多 少 个 缺陷 ， 但 是 计算 功能 点 却 不 是 那么 简单 
的 。 因 此 大 多 数 团 队 使 用 简单 的 度量 ,缺陷 /KLOC。 ) 如 果 你 的 经 理 过 度 强 调 缩减 缺陷 密 
度 值 ， 团 队 也 会 相应 地 作出 反应 。 确 保 代 码 出 现 更 少 的 缺陷 比 玩弄 数值 要 难得 多 。 最 简 
单 的 方法 就 是 增加 代码 行 数 。 

或 许 你 相信 大 部 分 程序 员 不 会 那么 狭 诈 。 或 许 不 会 吧 ! 但 是 当 你 要 求 他 们 将 两 个 几乎 一 
样 的 、 包 含 千 行 的 函数 合成 一 个 时 ,他 们 就 会 想到 在 KLOC 上 的 损失 , 这 样 会 增加 缺陷 密 
度 值 。 想 要 说 服 他 们 相信 消除 重复 代码 的 重要 性 ， 只 能 祝 你 好 运 了 。 
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CD 功能 点 是 描述 信息 系统 向 用 户 提供 了 多 少 功能 的 度量 单位 。 可 以 参考 https://en.wikipedia.org/wiki/Function_point。 
译 者 注 
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口 一 味 地 追求 速度 :“ 发 布 吧 ! 不 要 花 时 间 重 构 了 ! ”你 可 以 责怪 工程 经 理 不 理解 保持 系统 
设计 整洁 的 重要 性 吗 ? 当然 ， 可 能 看 上 去 你 的 进度 在 一 段 时 间 内 是 快 了 些 ， 但 任 由 系统 
质量 变 差 终 会 将 你 推 人 深渊 。 


要 勇敢 说 “不 ”， 否 则 的 话 ， 就 自己 保持 重 构 。 将 每 几 分 钟 整理 一 下 代码 作为 TDD 的 一 个 
环节 。 如 果 有 人 间 为 什么 ,你 可 以 这 样 说 :“ 这 就 是 我 作为 负责 任 的 专业 人 员 的 做 事 方法 。” 
必须 抓 住 每 次 测试 提供 的 机 会 ， 代 码 中 的 问题 会 很 快 累 积 并 开始 拖 慢 开发 速度 。 你 甚至 
会 觉得 必须 请 求 做 一 次 重 构 近代 。 不 要 这 人 么 做 ! 非 技 术 人 员 对 重 构 是 什么 一 无 所 知 。 他 
们 会 把 你 的 请 求 理 解 为 “程序 员 只 是 想 玩 玩 罢 了 ， 我 不 会 在 此 迭代 中 得 到 任何 与 业务 有 
关 的 回报 ”。 
问题 是 ,无 论 怎样 努力 尝试 ， 当 新 功能 不 能 容易 地 加 入 到 已 有 代码 中 时 ， 你 不 可 避免 地 要 做 
些 迭 代 , 这 会 使 功能 的 完成 比 预期 要 晚 一 些 。 如 果 发 生 这 样 的 情况 , 就 请 求 原谅 并 做 细致 的 调查 ， 
看 看 怎样 才能 避免 这 些 额 外 的 开销 。 不 要 让 这 习惯 性 地 发 生 。 

































































6.5 结束语 


在 本 章 中 ,你 学 习 了 怎样 确保 软件 维持 高 质量 的 设计 ， 以 便 日 后 可 以 轻松 地 维护 ; 学 习 了 怎 
样 在 TDD 的 重 构 阶段 应 用 简单 设计 理念 ; 同时 , 还 了 解 了 持续 、 增 量 重 构 的 重要 性 ,以 及 会 阻碍 
充分 重 构 的 一 些 因素 。 

不 要 就 此 停 下 ， 要 确保 对 测试 应 用 相似 的 设计 理念 ， 我 们 将 在 下 一 章 中 深入 探讨 这 个 主题 。 
同时 , 你 也 要 通过 其 他 途径 阅读 关于 面向 对 象 设计 的 更 多 知识 。 你 所 了 解 的 良好 设计 的 所 有 知识 
将 帮助 你 成 功 地 开发 系统 。 





























7.4 开场 白 


你 已 经 学 习 了 怎样 测试 驱动 开发 , 更 重要 的 是 , 在 上 一 章 中 学 习 了 怎样 利用 TDD 打 麻 系 统 设 
计 。 安 全 且 持 续 的 重 构 可 以 让 产品 代码 保持 活力 。 在 这 一 章 中 ， 你 将 学 习 怎 样 设计 测试 ， 以 便 提 
升 回报 并 避免 其 成 为 维护 负担 。 
可 通过 下 列 核心 理念 学 习 怎 样 开发 高 质量 的 测试 。 
口 FIRST 助 记 符 一 一 审核 测试 的 重要 方法 
口 一 个 测试 一 个 断言 一 一 帮助 限制 测试 大 小 的 准则 
口 测试 抽象 一 一 保持 测试 可 读 性 的 核心 原则 

















7.2 测试 先行 


想 知 道 你 编写 的 单元 测试 是 一 个 好 的 测试 吗 ? 可 以 对 照 FIRST 原 则 (由 Brett Schuchert 和 Tim 
Ottinger 提 出 ) 来 审查 。 这 个 助 记 符 可 以 提醒 你 TDD 定 义 中 的 关键 部 分 : 测试 先行 。 
FIRST 可 以 分 解 为 如 下 部 分 : 


O FERRE (Fast ); 

O I 是 独立 ( Isolated ); 

O R 是 可 重复 ( Repeatable ); 

O S 是 自我 验证 ( Self-verifying ); 
口 T 是 及 时 (Timely )。 























7.2.1 快速 


通过 规定 、 构 建 、 重 构 的 核心 周期 ,TDD 支 持 增 量 和 迭代 的 开发 方式 ,每 个 周期 应 该 多 长 呢 ? 
越 短 越 好 。 当 代码 不 工作 或 破坏 了 其 他 功能 时 ， 你 需要 马上 知道 情况 。 在 引入 一 个 缺陷 到 发 现 它 
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之 前 ， 生 成 的 代码 越 多 ， 找 到 并 修复 该 缺陷 所 耗费 的 时 间 就 越 长 。 你 需要 超 快 速 的 反馈 ! 

编写 代码 时 ,我 们 都 会 犯错 。 初 写 的 代码 很 难 达到 很 好 的 设计 ， 就 像 作 家 写 初 稿 一 样 ， 第 
阶段 编写 的 代码 往往 显得 粗糙 。 但 胡乱 堆砌 的 代码 会 越 来 越 难以 修改 。 最 可 能 让 代码 回 到 正轨 的 
做 法 是 什么 呢 ? 持续 地 检查 、 整 理 每 一 点 代码 。 


必须 确保 所 修改 的 或 新 加 的 测试 可 以 通过 ， 且 所 做 的 改动 不 会 破坏 系统 中 的 其 他 代码 。 每 做 
一 次 小 的 改动 ， 就 要 运行 一 下 所 有 的 单元 测试 。 
理想 情况 下 ， 在 获得 反馈 前 ， 要 编写 一 点 点 代码 ( 如 一 两 行 ) 但 这 样 做 会 增加 编译 、 链 接 
和 运行 测试 集 的 开销 。 

保持 周期 的 低 开 销 有 多 重要 呢 ? 如 果 平 均 需要 三 到 四 秒 来 编译 、 链 接 和 运行 测试 的 话 , 那么 
增 量 开发 只 需要 很 少 的 代码 就 能 得 到 很 多 反馈 。 但 试想 一 下 , 如 果 测 试 集 需要 花费 两 分 钟 来 构建 
和 运行 ， 你 会 多 久 运行 一 次 呢 ? 或 许 每 十 分 钟 或 十 五 分 钟 一 次 ?如 果 运 行 一 遍 测 试 需要 二 十 分 
钟 ， 恐 怕 一 天 也 就 只 能 运行 几 澳 。 

如 果 没 有 快速 反馈 ,你 编写 的 测试 会 减少 ,代码 重 构 会 更 少 , 从 引入 问题 到 发 现 问题 的 间隔 
也 会 变 长 。 依 赖 以 往 的 结果 意味 着 ， 只 能 获得 很 少 的 TDD 的 潜在 益处 。 这 时 ， 你 也 可 能 会 选择 放 
弃 TDD。 不 要 成 为 这 样 的 人 ! 

1. 构建 的 开销 


C++ 系统 的 构建 时 间 是 一 个 很 大 的 问题 。 在 大 型 系统 中 编译 、 链 接 可 能 需要 好 几 分 钟 ， 有 时 
要 更 长 时 间 。 


大 部 分 构建 时 间 与 代码 的 依赖 结构 直接 相关 。 依 赖 于 改动 的 代码 必须 重新 编译 。 


要 想 很 好 地 践 行 TDD, 需要 打造 一 个 最 小 化 大 量 重 编译 的 设计 。 如 果 一 个 常用 的 类 暴露 了 大 
量 的 接口 , 那么 接口 变化 时 必须 重新 编译 使 用 此 类 的 客户 端 , 即便 你 的 改动 和 它们 对 这 个 类 的 使 
用 没有 交集 。 按 照 接口 隔离 原则 (Interface Segregation Principle, ISP, ( 敏捷 软件 开发 : 原则 、 
模式 与 实践 》)， 迫 使 客户 端 程序 依赖 一 个 它们 不 用 的 接口 意味 着 存在 设计 缺陷 。 

同样 ， 滥 用 其 他 原则 会 导致 编译 时 间 过 长 。 依 赖 倒置 原则 ( Dependency Inversion Principle, 
DIP ) 让 你 依赖 抽象 ， 而 非 实现 细节 (《 敏 捷 软 件 开发 : 原则 、 模 式 与 实践 》)。 如 果 改 变 了 具体 类 
的 细节 ， 那 么 必须 重新 编译 所 有 客户 端 程序 。 

可 以 引入 一 个 接口 一 一 一 个 纯 虚 空 类 ， 个 具体 类 来 实现 。 如 果 改 动 具体 类 的 实现 细节 ， 
客户 端 程序 通过 接口 提供 的 抽象 与 其 交互 ， 且 不 会 触发 客户 端 程序 的 重 编译 。 

如 果 在 重 构 的 过 程 中 引入 了 新 的 私有 方法 ,你 就 会 发 现 , 重新 构建 会 耗 时 很 入 ,这 会 让 人 失 
去 耐心 。 或 许可 以 考虑 使 用 “指针 实现 ”( pointerto implementation，PIMPL ) 惯用 法 。 为 了 使 用 
PIMPL， 要 将 具体 的 实现 细节 提取 成 一 个 独立 的 实现 类 。 将 来 自 接口 的 调用 委托 给 这 个 实现 类 。 
然后 就 可 以 自由 地 改变 实现 随心所欲 地 创建 新 的 函数 了 , 而 不 用 重新 编译 依赖 公开 接口 的 代码 。 
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有 了 TDD 后 , 你 的 设计 抉择 不 再 是 模糊 不 清 的 思虑 ; 这 些 抉择 直接 关系 到 你 能 不 能 成 功 。 用 
TDD 获 得 成 功 的 诀窍 是 ， 保 持 整 洁 、 高 效 。 

2. 对 协作 者 的 依赖 

依赖 改动 会 增加 编译 时 间 。 为 了 运行 这 些 测试 , 对 依赖 的 担忧 开始 发 生 转 变 : 在 测试 其 他 代 
码 时 产生 的 依赖 增加 了 测试 的 执行 时 间 。 

如 果 测 试 代 码 和 另外 一 个 类 交互 ， 且 这 个 类 必须 调用 外 部 API ( 如 一 个 数据 库 调 用 ), 那么 测 
试 必须 等 竺 API 调用 完成 。( 此 时 , 测试 变 成 了 集成 测试 , 而 非 单元 测试 ) 花 几 毫秒 建立 数据 库 连 
接 并 执行 一 次 查询 ， 似 乎 不 会 太 浪费 时 间 。 但 是 ,如果 拥有 几 千 个 测试 的 测试 集中 的 大 部 分 测试 
都 有 此 和 开销， 那么 就 要 花费 几 分 钟 或 更 长 时 间 才能 运行 完整 个 测试 集 。 

3. 运行 一 个 测试 子 集 

大 部 分 单元 测试 工具 允许 运行 整个 测试 集 的 一 个 子 集 。 例 如 ，Google Test 可 以 指定 一 个 过 滤 
器 。 举 例 来 说 ， 下 面 的 命令 行 给 测试 传递 了 一 个 过 滤器 ,使 所 有 fixture 名 称 以 Holding 开 头 的 测试 
或 名 称 中 包含 Avail 的 测试 得 以 运行 。 运 行 更 小 的 测试 子 集 能 节省 一 些 执行 时 间 。 

./test --gtest filter-Holding*.*Avail* 

能 这 样 做 不 代表 应 该 这 么 做 …… 至 少 不 该 习惯 性 地 使 用 。 习惯 性 地 过 滤 掉 一 些 测试 , 说 明 存 
在 更 大 的 问题 一 一 测试 依赖 太 多 的 慢 速 因素 。 先 处 理 真 正 的 问题 ! 

当 不 能 容易 地 运行 所 有 测试 时 ， 不 要 立刻 一 次 只 运行 一 个 测试 。 要 找到 一 次 运行 尽 可 能 
的 测试 的 方法 。 至 少 在 一 次 运行 一 个 测试 前 ， 尝 试 在 特定 fixture ( 如 Holding*.* ) 下 运行 所 有 
的 测试 。 

在 初期 运行 测试 的 子 集 或 许 能 节省 点 时 间 , 但 请 记 住 ,运行 的 测试 越 少 , 今后 发 现 的 问题 就 
会 越 多 ， 进 而 也 就 需要 更 多 时 间 来 进行 修复 。 










































































7.2.2 ”独立 


使 用 TDD 时 ， 每 个 测试 至 少 应 该 失败 一 次 ， 那 么 在 创建 新 测试 时 ， 你 就 会 知道 失败 的 原因 。 
但 若 隔 了 三 天 或 三 个 月 呢 ? 测试 失败 的 原因 还 会 清晰 吗 ? 对 你 或 其 他 需要 找 出 问题 根源 的 人 来 
说 ,创建 一 个 可 以 由 多 个 原因 导致 失 败 的 测试 是 很 浪费 时 间 的 。 

测试 应 该 是 独立 的 , 即 只 会 因为 一 个 原因 失败 。 小 而 集中 的 测试 可 以 驱动 开发 出 一 小 段 行 为 ， 
从 而 增加 了 独立 性 。 

同时 ,每 个 测试 应 该 验证 一 小 段 独立 于 外 部 因素 的 逻辑 。 如 果 测 试 所 验证 的 代码 要 与 数据 库 、 
文件 系统 或 其 他 的 API 交 互 ， 那 么 导致 测试 失败 的 因素 可 以 是 很 多 种 。 引 入 测试 替身 〈 参见 第 5 
38 ) 可 以 获得 独立 性 。 
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测试 不 仅 要 独立 于 产品 系统 的 外 部 因素 , 还 要 彼此 独立 。 使 用 静态 数据 的 所 有 测试 都 可 能 因 
为 旧 的 数据 而 失败 。 
如 果 测 试 需要 大 量 的 设置 , 或 产品 代码 可 能 保持 旧 的 数据 ,你 会 发 现 , 深入 调查 才能 找到 导 
致 测试 失败 的 细微 改动 。 可 以 引入 前 置 条 件 断 言 来 验证 测试 在 Arrange 阶 段 的 所 有 假设 。 














c7/2/libraryTest/HoldingTest.cpp 
TEST F(ACheckedInHolding, UpdatesDateDueOnCheckout) 


1 
» ASSERT TRUE(IsAvailableAt(holding, *arbitraryBranch)); 


holding-»CheckOut (ArbitraryDate); 
ASSERT THAT(holding-»DueDate(), 
Eq(ArbitraryDate + date duration(Book::B00K CHECKOUT PERIOD))); 


图 书馆 应 用 程序 

本 章 的 代码 示例 来 自 于 一 个 小 型 演示 图 书馆 系统 。 一 些 关键 术语 的 定义 可 以 帮助 你 更 好 
地 理解 示例 。 顾 客 可 以 从 分 馆 中 签 出 或 租借 藏书 。 顾 客 是 一 个 人 ; 分 馆 是 图 书 系统 中 的 一 个 
物理 位 置 ; 藏书 是 图 书馆 中 的 书 的 副本 。 





如 果 前 置 条 件 断 言 失败 ， 你 会 少 浪费 些 时 间 查 找 、 修 复 问题 。 但 是 ， 如 果 发 现 要 经 常 使 用 这 
一 技巧 , 还 是 找 一 个 简化 设计 的 方法 吧 一 一 前 置 条 件 断 言 意味 着 你 对 系统 的 理解 还 不 够 , 也 意味 
着 你 在 设置 阶段 隐藏 太 多 的 信息 。 














7.23 ”可 重复 


高 质量 的 单元 测试 是 可 重复 的 ， 即 可 以 一 遍 遍地 运行 , 并 且 总 是 获得 相同 的 结果 , 无 论 其 他 
测试 《如 果 有 的 话 ) 是 否 先 运行 。 测 试 集 的 快速 反馈 能 够 提供 很 多 东西 ， 有 时 我 会 再 运行 一 次 ， 
只 是 为 了 得 到 测试 全 部 通过 的 满足 感 。 有 时 , 虽然 之 前 的 一 次 测试 通过 了 , 接 下 来 的 运行 却 是 失 
败 的 。 

间 欣 性 的 测试 失败 不 是 一 件 好 事 。 这 意味 着 一 定 程度 上 的 不 确定 性 或 测试 运行 中 存在 异常 行 
为 。 找 到 异常 行为 的 原因 可 能 需要 大 量 的 精力 。 

下 列 原因 可 能 导致 测试 的 间歇 性 失败 。 

口 静态 数据 : 好 的 单元 测试 不 会 依赖 其 他 测试 的 影响 ， 同 样 ， 也 不 会 让 残留 的 状态 造成 问 

题 。 如 果 项 态 数据 可 能 使 测试 失败 ， 那 么 你 在 加 入 新 测试 或 移 除 一 些 测试 时 ， 才 可 能 看 
到 真正 的 失败 。 在 一 些 单元 测试 框架 中 ， 测 试 被 加 入 到 基于 哈 希 的 集合 中 ， 这 意味 着 测 
试 的 执行 顺序 会 随 着 测试 数量 的 变化 而 改变 。 
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O 不 稳定 的 外 部 服务 : 避免 编写 依赖 于 你 控制 不 了 的 外 在 因素 的 单元 测试 ， 如 当前 时 间 、 
文件 系统 、 数 据 库 以 及 其 他 一 些 API 调 用 。 可 在 必要 时 引入 测试 蔡 身 ( 参见 第 5 章 ) 来 打 
破 这 种 依赖 关系 。 

口 程序 并 发 : 多 线程 或 其 他 多 道 执行 技术 会 引入 一 些 不 确定 的 行为 ， 这 对 单元 测试 而 言 可 
能 是 极 大 的 挑战 。 参 见 第 9 章 来 获得 有 关 测 试 驱动 开发 多 线程 代码 的 建议 。 

















7.24 自我 验证 

自动 化 测试 解放 了 你 自己 一 一 淘汰 了 慢 速 是 有 风险 的 手动 测试 ,单元 测试 必须 执行 代码 并 验 
证 代码 能 否 在 你 不 参与 的 情况 下 自动 工作 ,一 个 单元 测试 至 少 有 一 个 断言 。 它 必须 在 其 存在 的 周 
期 里 至 少 失 败 一 次 ， 未 来 也 必须 有 一 些 方法 让 它 失 败 。 

不 要 在 这 条 准则 上 有 任何 退让 。 不 要 在 测试 中 加 入 cout 语 句 来 替代 断言 。 手动 的 控制 台 验 证 
或 日 志文 件 输出 既 浪 费时 间 也 增加 风险 。 

投机 取 巧 的 程序 员 会 发 现 , 编写 没有 断言 的 测试 可 以 提升 测试 覆盖 率 ( 受 误导 的 经 理 所 追 求 
的 目标 )。 这 些 测试 纯 属 浪费 精力 ， 但 在 不 做 任何 断言 的 情况 下 执行 大 量 的 代码 却 改善 了 指标 。 























7.25 ”及 时 

什么 时 候 编写 测试 ”及 时 编写 意味 着 你 要 先 编写 测试 。 为 什么 ”因为 你 在 做 TDD, 而 且 正 是 
因为 它 是 保持 高 质量 代码 库 的 最 好 方法 ， 所 以 你 才 使 用 它 。 

同样 ， 不 要 在 编写 代码 前 编写 一 堆 测 试 。 相 反 ， 每 次 只 写 一 个 测试 ， 其 至 在 每 个 测试 中 一 
次 只 加 入 一 个 断言 。 要 尽 可 能 地 增 量 化 ， 将 每 个 测试 视 作 一 小 段 规范 ， 让 你 可 以 快速 驱动 一 臻 
的 行为 。 



































7.3 ”一 个 测试 一 个 断言 

在 系统 中 测试 驱动 开发 小 而 不 相关 联 的 行为 。 在 TDD 的 每 个 周期 中 , 你 要 规定 行为 以 及 验证 
此 行为 确实 可 行 的 方法 一 一 断言 。 

为 了 证 以 后 的 程序 员 理解 系统 涉及 的 行为 , 测试 必须 清楚 地 陈述 意图 。 意图 最 重要 的 声明 是 
测试 名 称 ， 它 应 该 澄清 上 下 文 和 目标 。 

测试 覆盖 的 行为 越 多 ,测试 名 就 越 不 能 准确 地 描述 行为 。 

在 图 书馆 系统 中 , 藏 本 在 顾客 借 出 后 就 不 可 再 借 了 ,在 顾客 归还 后 恢复 为 可 借 状 态 。 可 设计 
一 个 专门 用 于 可 借 性 的 测试 。 
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c7/3/libraryTest/HoldingTest.cpp 

TEST F(HoldingTest, Availability) 

1 
holding--Transfer(EAST BRANCH); 
holding-»CheckOut (ArbitraryDate); 
EXPECT FALSE(holding-»-IsAvailable()); 


date nextDay = ArbitraryDate + date duration(1) 
holding-»CheckIn(nextDay, EAST BRANCH); 
EXPECT TRUE (holding-»IsAvailable()); 

} 

将 多 个 行为 揉 进 一 个 测试 , 在 一 定 程 度 上 将 它们 绑 在 了 一 起 。 你 可 能 发 现 许多 方法 会 和 其 他 
方法 一 同 使 用 , 这 意味 着 找 出 哪个 方法 是 哪个 测试 所 测 是 相当 困难 的 。 其 缺点 是 ,阅读 测试 的 人 
需要 花费 更 多 的 时 间 弄 明白 怎么 回 事 , 尤其 是 当 你 往 一 个 测试 中 加 入 3 个 、4 个 或 数 不 清 的 行为 时 。 

分 成 多 个 测试 使 你 能 够 用 测试 名 清楚 地 表明 在 何 种 情况 下 发 生 了 何 种 行为 。 同 时 , 也 能 让 你 
充分 利用 Arrange-Act-Assert/Given-When-Then 来 增加 清晰 度 。 





























c7/3/libraryTest/HoldingTest.cpp 
TEST_F(AHolding, IsNotAvailableAfterCheckout) 


holding->Transfer(EAST BRANCH); 
holding-»CheckOut (ArbitraryDate); 


EXPECT THAT(holding-»IsAvailable(), Eq(false)); 
} 


TEST_F(AHolding, IsAvailableAfterCheckin) 
{ 
holding->Transfer(EAST_BRANCH) ; 
holding-»CheckOut (ArbitraryDate); 





holding-»CheckIn(ArbitraryDate + date duration(1), EAST BRANCH); 


EXPECT THAT(holding-»IsAvailable(), Eq(true)); 
} 


单一 目的 测试 的 名 称 能 自我 澄清 , 即 不 需要 阅读 测试 代码 来 了 解 它 做 了 什么 。 这 些 测 试 名 的 
完整 集合 正如 系统 能 力 的 索引 表 。 你 开始 将 测试 名 称 视 作 相关 的 行为 组 ,而 不 仅仅 是 不 相关 的 行 
为 验证 。 

全 面 地 查看 测试 名 称 能 引发 你 思考 一 些 缺失 的 测试 。“ 我 们 有 描述 藏 本 借 出 和 归还 后 的 可 用 
性 的 测试 。 在 进货 过 程 中 向 系统 加 入 新 书 时 ,书籍 可 用 性 的 哪些 量 要 设置 为 真 呢 ? 最 好 编写 一 个 
测试 1” 

你 曾经 有 多 于 一 个 断言 的 测试 吗 ? 要 尽量 保证 只 有 一 个 。 但 多 于 一 个 有 时 也 是 合理 的 。 
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断言 是 后 置 条 件 。 如 果 一 个 行为 需要 多 个 断言 ， 可 在 测试 中 引入 。 想 想 IsEmpty() ,通常 是 
为 了 增加 表达 力 而 引入 它 ， 而 这 一 表达 力 是 Size( ) 这 类 函数 所 不 具备 的 。 你 可 能 会 在 判断 一 个 
新 集合 是 否 为 空 时 ， 选 择 同时 使 用 这 两 个 函数 。 


同时 ， 也 可 能 在 验证 一 大 堆 数据 时 引入 多 个 断言 。 








c7/3/libraryTest/HoldingTest.cpp 
TEST F(AHolding, CanBeCreatedFromAnother) 


1 
Holding holding(THE TRIAL CLASSIFICATION, 1); 
holding.Transfer(EAST BRANCH); 
Holding copy(holding, 2); 
ASSERT THAT(copy.Classification(), Eq(THE TRIAL CLASSIFICATION)); 
ASSERT THAT(copy.CopyNumber(), Eq(2)); 
ASSERT THAT(copy.CurrentBranch(), Eq(EAST BRANCH) ) ; 
ASSERT TRUE(copy.LastCheckedOutOn().is not a date()); 
} 


最 后 , 在 行为 的 描述 不 再 变化 的 前 提 下 , 越 来 越 多 的 数据 加 入 后 , 实现 变 得 越 来 越 特定 化 时 ， 
你 可 以 合并 断言 。 例 如 ， 以 下 的 实用 类 将 罗马 数字 转换 成 了 阿拉 伯 数 字 。 











c7/3/libraryTest/RomanTest.cpp 


TEST(ARomanConverter, AnswersArabicEquivalents) 


1 
RomanConverter converter; 
ASSERT EQ("I", converter.convert(1)); 
ASSERT EQ("II", converter.convert(2)); 
ASSERT EQ("III", converter.convert(3)); 
ASSERT EQ("IV", converter.convert(4)); 
ASSERT EQ("V", converter.convert(5)); 
JP UM 

} 


对 于 这 些 情况 ,可 以 将 测试 拆 分 开 。 但 将 测试 拆 分 显得 没有 太 大 意义 ， 可 以 用 能 想到 的 测试 
名 来 说 明 : ConvertsRomanIIToArabic 、ConvertsRomanIIIToArabic 等 。 又 或 者 CopyPopulates- 
Classification 、CopyPopulatesCopyNumber 等 。 
要 说 记 一 个 关键 的 准则 一 一 一 个 测试 只 有 一 个 行为 。 如 果 还 不 够 清楚 ， 那 么 可 以 这 样 认为 ， 
任何 拥有 条 件 逻 辑 ( 如 if 语 句 ) 的 测试 几乎 都 与 此 准则 相悖。 
个 测试 一 个 断言 不 是 硬性 原则 ， 但 通常 是 更 好 的 选择 。 要 努力 让 一 个 测试 有 更 少 的 断言 ， 
而 不 是 更 多 。 越 是 这 样 做 ， 越 会 发 现 其 价值 所 在 。 就 目前 来 说 ， 尽 量 让 一 个 测试 只 有 一 个 断言 ， 


然后 思 7 结果 。 
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7.4 测试 抽象 
Bob 大 权 将 抽象 定义 为 “去 粗 取 精 ””。 抽象 在 测试 和 面向 对 象 设计 中 同等 重要 。 因 为 你 要 将 
测试 当 作文 档 来 读 ， 所 以 它们 必须 正中 其 意 ， 以 最 清晰 、 最 简洁 的 方式 声明 其 意图 。 


简单 地 讲 ,可 以 通过 下 面 几 个 途径 增加 测试 的 抽象 度 :使 它们 更 加 内 聚 (一 个 测试 一 个 断言 ); 
更 好 地 命名 ( 测试 自身 及 其 内 部 的 代码 ); 抽 象 掉 多 余 的 东西 ( 可 利用 fixture 辅 助 函 数 或 setUp() ) 


下 面 来 看 一 下 九 种 不 同 的 测试 坏 味 ， 并 相应 地 整理 测试 代码 。 












































7.4.1 BERRIE 


从 LineReader 类 的 一 个 测试 开始 ， 该 测试 名 没有 过 多 说 明 LineReader 是 怎样 工作 的 。 和 希望 测 
试 的 整理 工作 能 够 帮 到 我 们 。 

















c7/3/linereader/LineReaderTest.cpp 
TEST(LineReaderTest, OneLine) 1 
const int fd - TemporaryFile(); 
write(fd, "a", 1); 
lseek(fd, 0, SEEK SET); 
LineReader reader(fd); 


vvYvY 


const char *line; 

unsigned len; 

ASSERT TRUE(reader.GetNextLine(&line, &len)); 

ASSERT EQ(len, (unsigned)1); 

ASSERT EQ(line[0], 'a'); 

ASSERT EQ(line[1], 0); 


reader.PopLine(len); 





ASSERT FALSE(reader.GetNextLine(&line, &len)); 


close(fd); 
} 


测试 的 前 三 行 创建 了 一 个 临 时 文件 , 并 在 文件 里 写 人 了 一 个 字符 ( "a" ), 然后 将 文件 指针 指 
向 文件 涉 部 。 这 个 膝 肿 的 构造 需要 阅读 测试 的 人 看 一 些 无 关 紧 要 的 测试 设置 细节 。 可 以 用 一 行 抽 
象 来 奉 代 它 。 








c7/A/linereader/LineReaderTest.cpp 


TEST(LineReaderTest, OneLine) 1 
» const int fd - WriteTemporaryFile("a"); 
LineReader reader(fd); 


const char *line; 








中 “ 粗 ” 在 这 里 表示 不 相关 的 部 分 ， 而 “ 精 ” 则 表示 关键 的 部 分 。 一 一 译 者 注 
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unsigned len; 

ASSERT TRUE(reader.GetNextLine(&line, &len)); 
ASSERT EQ(len, (unsigned)1); 

ASSERT EQ(line[0], 'a'); 

ASSERT EQ(line[1], 0); 

reader.PopLine(len); 


ASSERT FALSE(reader.GetNextLine(&line, &len)); 


close(fd); 
} 


测试 变 短 了 几 行 , 而且 隐藏 了 创建 一 个 有 少量 数据 的 文件 的 实现 细节 ,一 般 不 需要 关心 这 
极 少数 需要 的 情况 下 ， 可 以 浏览 来 了 解 WriteTemporaryFile() 到 底 做 了 什么 





7.4.2 不 相关 的 细节 


这 个 测试 首先 创建 了 一 个 临时 文件 。 如 果 最 初 写 测试 的 程序 员 是 一 个 优秀 的 编码 人 员 , 他 应 
确保 在 测试 末尾 关闭 文件 。 























c7/5/linereader/LineReaderTest.cpp 
TEST(LineReaderTest, OneLine) { 
» const int fd - WriteTemporaryFile("a"); 
LineReader reader(fd); 


const char *line; 

unsigned len; 

ASSERT TRUE(reader.GetNextLine(&line, &len)); 
ASSERT EQ(len, (unsigned)1); 

ASSERT EQ(line[0], 'a'); 

ASSERT EQ(line[1], 0); 

reader.PopLine(len); 


ASSERT FALSE(reader.GetNextLine(&line, &len)); 


» close(fd); 
} 


对 ctLose() 的 调用 显得 有 点 乱 ， 这 是 在 理解 测试 时 让 人 分 心 的 另 一 个 实现 细节 。 可 以 利用 
TearDown ( ) 确保 文件 关闭 。 同 时 ， 也 可 以 将 变量 fd (文件 描述 符 ) 声明 的 类 型 信息 移 除 ， 将 其 
移 进 fixture。 





c7/6/linereader/LineReaderTest.cpp 


class LineReaderTest: public testing::Test ( 


public: 
> int fd; 
void TearDown() { 
> close(fd); 


H 
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TEST F(LineReaderTest, OneLine) { 
» fd = WriteTemporaryFile("a"); 
LineReader reader(fd); 


const char *Lline; 

unsigned len; 

ASSERT TRUE(reader.GetNextLine(&line, &len)); 
ASSERT EQ(len, (unsigned)1); 

ASSERT EQ(line[0], 'a'); 

ASSERT EQ(line[1], 0); 

reader.PopLine(len); 


ASSERT FALSE(reader.GetNextLine(&line, &len)); 
} 


现在 似乎 很 少 用 到 这 个 临时 变量 了 。 我 们 将 LineReader 实 例 的 创建 写成 一 行 。 





c7/7/linereader/LineReaderTest.cpp 


TEST F(LineReaderTest, OneLine) { 
» LineReader reader(WriteTemporaryFile("a")); 


const char *line; 

unsigned len; 

ASSERT TRUE(reader.GetNextLine(&line, &len)); 
ASSERT EQ(len, (unsigned)1); 

ASSERT EQ(line[0], 'a'); 

ASSERT EQ(line[1], 0); 

reader.PopLine(len); 


ASSERT FALSE(reader.GetNextLine(&line, &len)); 

















嗯 …… 还 有 点 小 问题 。 不 再 在 TearDown() 中 关闭 这 个 临时 文件 (相反 ， 试 图 关闭 一 个 未 初 
始 化 的 文件 描述 符 fd )， 我 们 选择 通过 支持 RAII 来 改善 LineReader 的 设计 ， 并 在 析 构 函数 中 自行 
关闭 文件 。( 要 想 更 深入 地 了 解 RAI 惯 用 法 ， 请 参见 http:/en.wikipedia.org/wiki/Resource 
Acquisition Is_Initialization。) 代码 的 实现 细节 留 给 读者 ! (或 者 你 可 以 看 一 下 提供 的 示例 源 代 
fi, ) 


测试 还 包含 了 一 些 大 多 数 时 候 不 需要 看 到 的 细节 一 一 声明 Line 和 ten 变量 的 两 行 代码 。 同 
时 ， 它 们 在 几 个 LineReader 的 测试 中 重复 出 现 。 让 我 们 去 掉 这 些 重复 代码 吧 ! 





























c7/8/linereader/LineReaderTest.cpp 


class LineReaderTest: public testing::Test ( 


public: 
int fd; 
» const char *line; 
» unsigned len; 


}; 
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TEST F(LineReaderTest, OneLine) { 
LineReader reader(WriteTemporaryFile("a")); 


ASSERT TRUE(reader.GetNextLine(&line, &len)); 
ASSERT EQ(len, (unsigned)1); 

ASSERT EQ(line[0], 'a'); 

ASSERT EQ(line[1], 0); 

reader.PopLine(len); 


ASSERT FALSE(reader.GetNextLine(&line, &len)); 


7.4.3 ”缺失 的 抽象 

许多 开发 者 经 常 忽 
J, 但 将 小 段 代码 提取 
了 解释 性 注释 的 需求 。 











视 创建 简单 抽象 的 契机 。 尽 管 为 获得 有 待 商检 的 收益 似乎 付出 了 额外 的 精 
为 辅助 函数 和 类 却 是 三 启 的 。 第 一 ,， 它 增强 了 代码 的 表达 力 ,， 潜在 地 消除 
TB. 它 提升 了 重用 这 些 代码 的 机 会 , 也 有 助 于 消除 大 量 的 重复 代码 。 第 




















三 ， 它 使 接 下 来 的 测试 更 易于 编写 。 





目前 的 测试 需要 三 行 代 码 来 验证 从 reader 中 读 取 下 一 行 的 结 且 


(i 
o 





c7/9/linereader/LineReaderTest.cpp 


TEST F(LineReaderTest, OneLine) { 
LineReader reader(WriteTemporaryFile("a")); 


ASSERT TRUE(reader.GetNextLine(&line, &len)); 


YYY 


ASSERT EQ(len, (unsigned)1); 
ASSERT EQ(line[0], 'a'); 
ASSERT EQ(line[1], 0); 


reader.PopLine(len); 


ASSERT FALSE(reader.GetNextLine(&line, &len)); 











个 辅助 函数 可 以 
也 可 以 引入 一 个 基于 匹 














将 三 个 断言 转 为 一 个 更 加 抽象 的 声明 。( 如 果 使 用 的 单元 测试 工具 支持 ， 
配 需 的 自 定 义 断 言 。) 











c7/10/linereader/LineReaderTest.cpp 

void ASSERT EQ WITH LENGTH( 
const char* expected, const char* actual, unsigned length) ( 
ASSERT EQ(length, strlen(actual)); 
ASSERT STREQ(expected, actual); 


} 


TEST F(LineReaderTest, OneLine) { 
LineReader reader(WriteTemporaryFile("a")); 


ASSERT TRUE(reader.GetNextLine(&line, &len)); 
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> . ASSERT EQ WITH LENGTH("a", line, len); 
reader.PopLine(len); 


ASSERT FALSE(reader.GetNextLine(&line, &len)); 
} 


7.4.4 多 重 断 言 


我 们 已 经 将 测试 精简 到 只 包含 几 行 语句 和 三 个 断言 。 现在 用 一 个 测试 一 个 断言 原则 来 创建 三 
个 测试 ， 每 一 个 测试 都 要 有 清晰 的 名 字 来 概括 其 意 














c7/11/linereader/LineReaderTest.cpp 

TEST F(GetNextLinefromLineReader, UpdatesLineAndLenOnRead) ( 
LineReader reader(WriteTemporaryFile("a")); 
reader.GetNextLine(&line, &len); 
ASSERT EQ WITH LENGTH("a", line, len); 

} 


TEST F(GetNextLinefromLineReader, AnswersTrueWhenLineAvailable) { 
LineReader reader(WriteTemporaryFile("a")); 
bool wasLineRead = reader.GetNextLine(&line, &len); 
ASSERT TRUE(wasLineRead); 

} 


TEST F(GetNextLinefromLineReader, AnswersFalseWhenAtEOF) { 
LineReader reader(WriteTemporaryFile("a")); 
reader.GetNextLine(&line, &len); 
reader.PopLine(len); 


bool wasLineRead = reader.GetNextLine(&line, &len); 
ASSERT FALSE(wasLineRead); 
} 


审阅 一 下 这 些 新 测试 及 其 名 称 ， 不 难 发 现 缺少 了 一 些 测 试 。 如 果 不 加 分 析 和 直觉 判断 ， 
PopLine () 的 行为 就 不 能 得 到 充分 的 说 明 , 我 们 也 会 思考 如 果 连 续 调 用 两 次 GetNextLine() 会 发 
生 什么 。 可 以 添加 漏 掉 的 测试 AdvancesToNextLineAfterPop 和 RepeatlyReturnCurrentRecord ( 这 
个 就 当 作 给 读者 的 练习 了 )。 


持续 地 审阅 所 有 的 测试 名 能 够 帮助 你 找到 规范 中 的 漏洞 。 











7.4.5 不 相关 的 数据 


测试 中 使 用 的 数据 有 助 于 了 解 测试 ,内 散在 代码 中 的 字面 常量 只 会 分 散 注意 力 , 更 糟糕 的 是 ， 
让 人 产生 疑惑 。 如 果 一 个 函数 调用 需要 参数 ， 但 这 些 参数 与 当前 的 测试 无 关 ， 通 常 可 以 传人 0 或 
类 似 的 数值 来 表示 空 〈 例 如 ， 字 符 串 就 用 "表示 )。 对 于 阅读 测试 的 人 来 说 ， 这 些 数据 应 该 提示 
“此 数据 无 关 ”。( 如 果 0 是 有 意义 的 值 ， 那 就 引入 一 个 常量 来 帮助 说 明 为 什么 。) 
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有 时 你 别 无 选择 ， 只 能 传递 一 个 非 0 或 非 空 的 值 。 这 时 ， 一 个 简单 的 常量 能 迅速 地 告诉 阅读 
人 员 他 们 需要 知道 的 东西 。 在 AnswersTrueWhenLineAvailable 测 试 中 ， 我 们 不 关心 文件 内 容 ， 所 
以 将 传 给 WriteTemporaryFite() 的 字符 "a" 替 换 为 意图 明显 的 名 称 。 











c7/12/linereader/LineReaderTest.cpp 


TEST F(GetNextLinefromLineReader, AnswersTrueWhenLineAvailable) { 
» LineReader reader(WriteTemporaryFile(ArbitraryText)); 


bool wasLineRead = reader.GetNextLine(&line, &len); 


ASSERT TRUE(wasLineRead); 
j 


对 腔 肿 的 测试 进行 一 些 处 理 后 , 可 以 得 到 三 个 简洁 的 测试 ,每 个 就 只 有 届 指 可 数 的 几 行 代码 
或 者 更 少 。 每 个 测试 都 清晰 易 懂 。 现 在 ,我 们 更 加 清楚 LineReader 的 行为 了 。 

为 了 嗅 出 更 多 代码 坏 味 ， 我 们 来 看 看 一 些 不 够 整洁 的 其 他 测试 一 -LineReader 的 测试 目前 已 
经 足够 好 了 。 


























7.4.6 不 必要 的 测试 代码 
有 一 些 代码 根本 就 不 属于 测试 。 本 节 讨 论 了 一 些 可 以 从 测试 中 完全 移 除 的 代码 。 
1. 断言 不 空 


段 错误 可 不 是 好 玩 的 。 解 引用 空 指针 是 不 会 有 好 结果 的 , 剩余 的 测试 会 因为 崩溃 而 无 法 运行 。 
防御 性 的 编程 自然 是 一 个 可 以 理解 的 应 对 方案 。 











c7/12/libraryTest/PersistenceTest.cpp 
TEST P(PersistenceTest, AddedItemCanBeRetrievedById) 


1 
persister-»-Add(*objectWithIdl); 
auto found = persister-»Get("1"); 
» ASSERT THAT(found, NotNull()); 
ASSERT THAT(*found, Eq(*objectWithIdl)); 
} 























但 是 请 记 住 , 之 所 以 设计 测试 , 是 为 了 驱动 开发 常规 行为 或 产生 预想 的 失败 。 对 于 持久 化 ?的 
代码 来 说 ， 已 经 有 一 个 测试 演示 了 何 时 Get () 会 返回 空 (Null )。 


c7/12/libraryTest/PersistenceTest.cpp 
TEST P(PersistenceTest, ReturnsNullPointerWhenItemNotFound) 














H 





CD 这 里 的 持久 化 就 是 将 数据 永久 保存 下 来 。 一 一 译 者 注 
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ASSERT THAT(persister-»Get("no id there"), IsNull()); 
} 
AddedItemCanBeRetrievedById 是 一 个 常规 路 径 的 测试 。 一 旦 测试 可 以 工作 ， 就 应 该 一 直 工 
作 …… 除 非 未 来 某 人 的 代码 引入 了 一 个 缺陷 或 内 存 分 配 失败 。 因 此 ,对 空 的 检查 (ASSERT_THAT 
(found, NotNull())) 在 此 常规 路 径 下 不 大 可 能 失败 。 


我 们 要 移 除 这 句 代 码 。( 应 该 杜绝 使 用 裸 指针 以 消除 后 患 。) 它 对 测试 的 文档 化 价值 贡献 并 不 
大 ,仅仅 是 为 了 安全 。 移 除 这 个 保护 语句 的 缺点 是 ,一 旦 指针 为 空 ， 就 会 产生 段 错误 。 我 们 也 乐 
于 对 此 作出 权衡 一 一 虽然 极 少 遇 到 ， 但 最 坏 的 情况 是 我 们 认可 这 个 段 错 误 ， 并 加 上 一 个 空 检查 ， 
然后 重新 运行 测试 来 验证 我 们 的 猜想 。 如 果 测 试 运行 得 很 快 ， 那 就 没什么 大 问题 。 


如 果 你 不 想 偶尔 几 次 测试 因 段 错误 骨 演 ,一些 单 元 测试 框架 提供 了 另 一 种 方案 , 该 方案 不 需 
要 一 个 额外 代码 行 来 验证 指针 。 例 如 ，Google Test 提 供 了 匹配 器 Pointee()。 


















































c7/13/libraryTest/PersistenceTest.cpp 
TEST P(PersistenceTest, AddedItemCanBeRetrievedById) 


1 
persister-»-Add(*objectWithIdl); 
auto found = persister-»Get("1"); 
» ASSERT THAT(found, Pointee(*objectWithId1l)); 
} 


在 做 TDD 时 , 想象 一 下 在 增 量 步 伐 中 为 指针 为 空 检查 编写 一 个 断言 。 这 样 做 没什么 问题 。 但 
是 ,一旦 你 认为 测试 完成 了 , 要 回头 看 一 下 代码 , 消除 一 些 不 具有 文档 化 意义 的 代码 。 通常 而 言 ， 
这 类 不 必要 的 代码 不 仅仅 只 有 指针 为 空 检查 的 断言 。 

2. 异常 处 理 

如 果 开 发 的 代码 会 产生 异常 , 你 需要 编写 一 个 测试 来 记录 这 个 异常 是 怎么 发 生 的 。 在 图 书馆 
系统 中 ， 增 加 分 馆 至 少 在 一 种 情形 下 会 抛 出 异常 。 






































c7/13/libraryTest/BranchServiceTest.cpp 
TEST F(BranchServiceTest, AddThrowsWhenNameNotUnique) 
1 


service.Add("samename", ""); 


ASSERT THROW(service.Add("samename", ""), DuplicateBranchNameException); 
} 


由 于 add( ) 函数 会 抛 出 异常 ， 一 些 程序 员 就 想 在 调用 add () 的 其 他 测试 中 做 些 保 护 措施 。 


c7/13/libraryTest/BranchServiceTest.cpp 
TEST F(BranchServiceTest, AddGeneratesUniqueId) 
1 





// 不 要 这 样 做 | 
// 从 不 会 产生 异常 的 测试 里 去 掉 tryVcatch 
// 不 会 产生 异常 


try 

1 
string idl - service.Add("namel", ""); 
string id2 - service.Add("name2", ""); 
ASSERT THAT(idl, Ne(id2)); 

} 

catch (...) { 
FAIL(); 

} 


} 


你 所 设计 的 大 部 分 测试 是 为 了 常规 代码 路 径 ， 它们 是 不 会 产生 异常 的 。 同样 ， 如 果 向 10 个 调 
用 add( ) 的 其 他 测试 中 加 入 try/catch 块 ， 那 么 你 就 增加 了 60 行 异常 处 理 代码 。 这 些 不 必要 的 异 
常 处 理 代码 只 会 影响 测试 的 可 读 性 ， 并 增加 维护 成 本 。 


不 被 异常 处 理 包 右 后 ， 相 关 的 测试 代码 显得 清洁 多 了 。 























c7/14/libraryTest/BranchServiceTest.cpp 


TEST F(BranchServiceTest, AddGeneratesUniqueId) 
1 
string idl 
string id2 


service.Add("namel", ""); 
service.Add("name2", ""); 


ASSERT THAT(idl, Ne(id2)); 
} 


3. 断言 失败 的 消息 


并 不 是 所 有 的 单元 测试 框架 都 支持 Hamcrest 风 格 标记 (ASSERT_THAT )。 或 者 你 的 代码 有 点 
老 旧 ， 仍 在 使 用 经 典 的 断言 ( 例如 ，ASSERT TRUE， 参见 第 4 章 )。( 或 者 你 会 发 现 Hamcrest 没 什 
么 大 的 意义 。) 

Hamcrest 风 格 的 断言 在 改善 错误 信息 方面 有 另外 的 好 处 。 相 比 之 下 ， 如 果 简 单 的 AsSERT 
TRUE 失败 ， 其 所 产生 的 错误 信息 或 许 不 能 立马 显示 你 想 要 知道 的 信息 。 像 CppUnit 这 样 的 测试 
架 ， 人 允许 你 提供 额外 的 参数 来 表达 断言 失败 时 该 显示 什么 信息 。 


CPPUNIT ASSERT MESSAGE(service.Find(*eastBranch), 
"unable to find the east branch"); 


我 的 建议 是 去 除 这 些 断 言 失败 的 消息 。 为 每 个 断言 都 加 入 这 类 信息 会 显得 十 分 混乱 ,从 而 导 
致 阅读 测试 变 得 困难 ， 并 增加 需要 维护 的 代码 。 阅 读 不 带 消息 的 断言 反而 很 轻松 。 

CPPUNIT ASSERT(service.Find(*eastBranch)); 

带 有 消息 的 断言 不 能 带 来 任何 有 价值 的 东西 。 就 像 正 常 的 代码 注释 一 样 , 应 该 尽量 避免 此 类 
需求 。 如 果 一 个 断言 不 带 失 败 消息 就 没 意 义 的 话 ， 那 么 还 是 先 解 决 测试 中 的 其 他 问题 吧 ! 











II | 
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如 果 一 个 测试 在 测试 集运 行 中 意外 失败 了 , 也 许 不 能 从 失败 消息 中 立刻 明确 地 看 出 原因 。 但 
通常 要 想 找 到 导致 失败 的 那 行 测 试 代码 , 需要 得 到 所 需 信息 。 如 果 必 要 ， 可 以 加 入 临时 的 失败 消 
息 ， 然 后 再 运行 一 裔 。 


4. 注释 
如 果 必 须 加 注释 来 说 明 测 试 是 做 什么 的 , 那 你 已 经 忘 了 测试 文档 化 的 要 领 。 重 写 测试 吧 , 专 
注 于 更 好 的 命名 和 内 聚 。 


或 许 有 时 会 看 到 类 似 如 下 的 测试 代码 : 




















» 


c7/15/libraryTest/BranchServiceTest.cpp 
// 添加 分 支 的 测试 ， 增 加 了 计数 
TEST F(BranchServiceTest, AddBranchIncrementsCount) 
1 
// 第 一 个 分 支 
service.Add(*eastBranch); // 东 
ASSERT THAT(service.BranchCount(), Eq(1)); 


// 第 二 个 分 支 

service.Add(*westBranch); // 9» 

ASSERT THAT(service.BranchCount(), Eq(2)); // count now 2 
} 


有 些 人 觉得 注释 很 有 帮助 , 但 注释 不 该 将 测试 所 做 的 ( 如 果 组 织 好 的 话 就 能 清楚 表明 的 ) 再 
说 一 遍 。 在 保留 测试 表达 力 的 前 提 下 ,努力 找到 一 个 去 除 注释 的 方法 。 对 前 一 个 测试 而 言 ， 去 除 
所 有 注释 并 不 影响 理解 。 


c7/16/libraryTest/BranchServiceTest.cpp 


TEST F(BranchServiceTest, AddBranchIncrementsCount) 
1 
service.Add(*eastBranch); 
ASSERT THAT(service.BranchCount(), Eq(1)); 
service.Add(*westBranch); 
ASSERT THAT(service.BranchCount(), Eq(2)); 
} 


5. 隐 含 之 意 

“为 什么 测试 这 样 断 言 其 行为 ? ”你 可 能 希望 ， 在 不 需要 浪费 时 间 分 析 测试 或 产品 代码 的 前 
提 下 ， 测 试 阅读 考 就 能 够 回答 这 个 问题 。 

通常 来 说 , 你 会 将 实现 细节 从 测试 移 至 SetUp( ) 或 另 一 个 辅助 函数 。 但 注意 , 不 要 隐藏 太 多 ! 
否则 测试 阅读 者 需要 看 得 更 深入 才能 知道 答案 。 合适 的 函数 和 变量 名 能 使 测试 意图 达到 顾名思义 
的 效果 。 


下 面 的 测试 需要 在 字里行间 阅读 一 番 : 














162 第 7 章 高 质量 测试 





c7/16/libraryTest/BranchServiceTest.cpp 
TEST F(ABranchService, ThrowsWhenDuplicateBranchAdded) 


1 
ASSERT THROW(service.Add("east", ""), DuplicateBranchNameException); 


) 
据 我 们 推测 ,Setup() 中 的 代码 在 系统 中 加 入 了 east 这 个 分 馆 信息 。 或 许 此 fixture 中 的 所 有 测 








试 都 需要 系统 中 已 有 一 个 分 馆 信 息 ， 因 此 ,在 Setup( ) 中 添加 east 来 消除 重复 代码 是 个 好 主意 。 
但 是 ， 为 什么 要 让 测试 者 做 额外 的 努力 来 理解 测试 呢 ? 


=j 
UL 


























可 以 通过 改变 其 名 称 ， 引 入 一 个 有 意义 的 fixture 名 称 来 阐明 测试 意图 。 


c7/17/libraryTest/BranchServiceTest.cpp 


TEST F(ABranchServiceWithOneBranchAdded, ThrowsWhenDuplicateBranchAdded) 
1 
ASSERT THROW(service.Add(alreadyAddedBranch-»Name(), ""), 
DuplicateBranchNameException); 


) 
还 有 一 个 简单 的 测试 ， 它 需要 测试 阅读 者 跟 进 细节 ， 并 计算 出 两 个 日 期 间 的 天 数 。 


c7/17/libraryTest/HoldingTest.cpp 


TEST F(AMovieHolding, AnswersDateDueWhenCheckedOut) 


1 
movie-»CheckOut(date(2013, Mar, 1)); 


date due = movie-»DueDate(); 


ASSERT THAT(due, Eq(date(2013, Mar, 8))); 
} 


在 简单 的 表达 式 中 加 个 断言 可 以 极 大 地 增加 可 读 性 。 


c7/18/libraryTest/HoldingTest.cpp 
TEST F(AMovieHolding, AnswersDateDueWhenCheckedOut) 
1 
date checkoutDate(2013, Mar, 1); 
movie-»CheckOut ( checkoutDate) ; 
date due = movie-»DueDate(); 
ASSERT THAT(due, Eq(checkoutDate + date duration(Book::MOVIE CHECKOUT PERIOD))); 
} 


将 期 待 的 测试 输出 和 测试 上 下 文 建立 联系 是 一 门 艺术 。 你 要 时 刻 具 有 创造 力 。 同 时 要 提醒 自 




















了 解 测试 的 内 部 细节 ， 但 其 他 人 则 不 需要 。 


6. 误导 性 的 组 织 
一 旦 习惯 了 用 Arrange-Act-Assert/Given-When-Then 组 织 测 试 , 你 也 会 期 待 以 此 方式 组 织 其 他 














测试 。 而 当 看 到 组 织 方式 与 此 不 太一 样 的 测试 时 ,你 的 速度 就 会 慢 下 来 。 因 为 你 必须 要 努力 弄 清 
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楚 哪 些 是 测试 的 设置 、 哪 些 是 真正 的 功能 ， 所 以 就 不 能 立即 理解 测试 。 找 出 下 面 这 个 测试 (故意 
使 用 了 无 用 的 名 称 ) 的 目的 需要 多 长 时 间 呢 ? 





c7/18/libraryTest/HoldingServiceTest.cpp 
TEST F(HoldingServiceTest, X) 
1 
HoldingBarcode barcode(THE TRIAL CLASSIFICATION, 1); 
string patronCardNumber("p5") ; 
CheckOut(barcode, branchl, patronCardNumber); 
date duration oneDayLate(Book::BO0OK CHECKOUT PERIOD + 1); 
holdingService.CheckIn(barcode.AsString(), 
*arbitraryDate + oneDayLate, branch2-»Id()); 
ASSERT THAT(FindPatronWithId(patronCardNumber).FineBalance(), 
Eq(Book: :BOOK DAILY FINE)); 


) 
用 AAA 模式 重 写 了 下 面 的 代码 ， 以 突出 相关 的 部 分 : 


c7/19/libraryTest/HoldingServiceTest.cpp 
TEST F(HoldingServiceTest, X) 


1 
HoldingBarcode barcode(THE TRIAL CLASSIFICATION, 1); 


string patronCardNumber("p5") ; 

CheckOut(barcode, branchl, patronCardNumber); 

date duration oneDayLate(Book::BO0OK CHECKOUT PERIOD + 1); 

holdingService.CheckIn(barcode.AsString(), 
*arbitraryDate + oneDayLate, branch2-»-Id()); 

ASSERT THAT(FindPatronWithId(patronCardNumber).FineBalance(), 
Eq(Book::BOOK DAILY FINE)); 

} 


将 执行 语句 分 开 ， 可 以 很 清楚 地 看 出 测试 的 重点 在 check-ins。 进 一 步 看 这 行 代码 ， 可 以 看 出 
它 涉及 后 来 的 check-ins。 了 解 了 系统 中 哪些 部 分 会 参与 其 中 ， 可 以 快速 地 转 到 测试 的 断言 部 分 ， 
并 判断 出 所 验证 的 行为 是 一 个 客户 的 罚金 ， 而 且 已 经 相应 地 更 新 了 。 

在 软件 开发 中 , 理解 现 有 代码 所 花费 的 时 间 是 众多 大 开销 之 一 。 你 所 做 的 每 件 小 事 都 有 助 于 
降低 此 开销 ，AAA 的 优点 就 是 几乎 不 会 带 来 任何 开销 。 

7. FRE RS o A 

在 软件 设计 中 ， 良 好 的 命名 是 你 可 以 做 的 最 重要 的 事情 之 一 。 通常 而 言 ， 好 的 名 称 是 测试 关 
联 问题 的 解决 方案 (参见 7.4.6 节 )。 同 时 你 也 会 发 现 ， 如 果 不 能 赋予 设计 一 个 简洁 的 名 称 ， 很 可 
能 意味 着 该 设计 存在 问题 。 

测试 本 身 没 什么 不 同 。 但 如 果 一 个 测试 的 名 称 含糊 不 清 或 需要 解释 , 那 它 就 不 能 充当 较 好 的 
文档 。 
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c7/19/libraryTest/PersistenceTest.cpp 


TEST P(PersistenceTest, RetrievedItemIsNewInstance) 





1 
persister-»-Add(*obj); 
ASSERT FALSE(obj == persister-»Get("1").get()); 
F 
下 面 的 简单 改动 会 让 阅读 测试 的 人 有 不 太一 样 的 感觉 。 


c7/20/libraryTest/PersistenceTest.cpp 


TEST P(PersistenceTest, RetrievedItemIsNewInstance) 
1 
persister-»-Add(*objectWithIdl); 


ASSERT FALSE(objectWithIdl == persister-»Get("1").get()); 
} 


不 用 对 所 有 相关 的 数据 命名 , 只 要 它 能 和 一 些 事情 很 容易 地 联系 起 来 即 可 。 下 面 是 一 个 示例 : 








c7/19/libraryTest/PatronTest.cpp 


TEST F(PatronTest, AddFineUpdatesFineBalance) 


1 
jane-»AddFine(10); 


ASSERT THAT(jane-»FineBalance(), Eq(10)); 
} 


很 明显 ， 传 递 给 AddFine( ) 的 参数 10 对 应 期 望 的 罚金 10。 

















7.5 ”结束 语 


保持 测试 整洁 、 直 接 明 了 有 助 于 你 将 它们 作为 文档 以 便 日 常 使 用 。 越 是 积极 地 阅读 测试 、 总 
是 先 想到 测试 , 就 越 会 投入 所 需 的 精力 来 长 期 地 维护 它们 。 可 以 用 本 章 提供 的 指导 方针 来 帮助 识 
别 、 纠 正 测试 设计 中 的 问题 。 

到 目前 为 止 , 你 已 经 学 习 了 大 量 关 于 TDD 的 知识 。 你 的 产品 代码 是 整洁 的 , 并 经 过 了 充分 的 
测试 , 测试 代码 也 一 样 整 洁 并 且 很 有 神 益 。 但 是 对 于 那些 不 是 你 或 你 的 队友 开发 的 代码 , 该 怎么 
办 呢 ? “我 好 像 曾 经 遇 到 过 !” 接 下 来 ， 我 们 将 探讨 来 自 于 遗留 代码 的 挑战 。 
























































第 8 章 


遂 留 代码 的 挑战 








8.1 开场 白 


现在 , 你 知道 怎样 用 TDD 方 法 编写 设计 良好 的 代码 了 。 但 对 于 大 部 分 程序 员 而 言 ， 大 部 分 时 
间 并 不 是 处 理 新 的 代码 , 而 是 要 穿梭 于 大 量 的 已 有 代码 间 , 且 这 些 代 码 是 没有 使 用 TDD 的 遗留 代 
码 。 其 中 大 部 分 是 聊 涩 难 风 、 设 计 糟 糕 、 构 建仓 促 的 代码 。 


该 怎样 应 对 这 浩瀚 如 海 的 遗留 代码 呢 ? 在 这 样 一 个 代码 库 中 仍然 可 以 使 用 TDD 吗 ? 或 者 
TDD 方 法 只 是 适合 原来 的 代码 库 吗 ? 本 章 中 介绍 的 一 些 技巧 可 以 帮助 你 处 理 这 些 棘 手 且 时 刻 存 
在 的 挑战 。 


你 将 在 本 章 中 学 习 一 些 在 没有 测试 的 情况 下 安全 地 重 构 代 码 的 技巧 和 思路 。 你 要 向 已 有 代码 
中 加 入 一 些 测试 来 描述 它们 的 行为 特征 ,以便 测试 开发 任何 所 需 的 改动 。 你 也 将 学 习 怎 样 使 用 链 
接 器 存根 ， 以 快速 摆脱 第 三 方 库 经 常 对 测试 造成 的 邻 人 头痛 的 问题 。 最 后 ， 你 会 学 习 到 一 种 管理 
大 规模 代码 重 构 的 技巧 一 一 Mikado 方 法 。 

在 本 章 的 测试 中 , 我 们 将 CppUTest 作 为 单元 测试 工具 。CppUTest 内 建 的 模拟 框架 可 以 使 处 理 
遗留 代码 的 测试 更 容易 些 。 可 根据 自己 的 喜好 继续 使 用 Google Tes/Google Mock， 只 需要 针对 单 
元 测试 代码 做 些 相 对 简单 的 改动 即 可 。 




























































































8.2 遗留 代码 


最 资深 的 开发 者 在 面 对 遗 留 代码 时 也 会 心 生 旦 惧 。 试 想 要 特 化 一 个 宛 长 且 未 经 测试 的 函数 中 
的 一 小 部 分 。 表 想象 一 下 ,你 要 实现 的 功能 是 在 30 多 行 的 代码 间 加 入 3 行 代码 ， 且 这 3 行 代码 要 文 
持 多 态 行 为 。 作为 经 验 老 到 的 程序 员 , 你 知道 合理 的 设计 是 将 相同 的 行为 重 构 至 一 个 地 方 。 因此 ， 
模板 方法 是 一 个 可 接受 的 方案 。 

(另外 一 种 方案 是 引入 条 件 分 文 。 但 当 函 数 被 各 种 各 样 的 标志 和 内 散 的 代码 块 困扰 时 ， 通 常 
来 说 ， 模 板 方 法 才 是 应 对 代码 逐渐 退化 的 良 方 。) 




















166  &83 遗留 代码 的 挑战 





但 从 经 验 来 看 , 许多 程序 员 对 做 正确 的 事情 有 点 抵触 ， 因 为 这 会 改变 已 有 的 、 可 以 工作 的 代 
码 。 或 许 他 们 以 前 经 历 过 此 类 改动 带 来 的 失败 ， 可 能 还 为 此 受到 过 责备 。“ 如 果 没 有 坏 ， 就 不 用 
修 !” 他 们 更 倾向 于 复制 、 粘 贴 ， 然 后 修改 。 代 码 最 终 变 成 了 60 行 而 非 少 于 35 行 。 因 此 ， 代 码 库 
中 的 重复 代码 激增 。 

避免 上 述 现象 的 最 好 方法 是 , 使 测试 能 够 提供 快速 的 反馈 。 这 在 大 多 数 系统 中 似乎 是 奢侈 品 ， 
遥 不 可 及 。Michael Feathers 在 《修改 代码 的 艺术 》 中 将 遗留 系统 定义 为 缺少 充足 测试 的 系统 。 

与 遗留 代码 库 打交道 会 面临 选择 。 你 选择 让 维护 成 本 不 断 增加 ,还 是 着 手 处 理 问 题 ? 若 采 取 
增 量 的 方法 并 使 用 本 章 中 列 出 的 一 些 技 巧 , 你 会 发 现 问 题 是 有 可 能 解决 的 。 或 许 大 多 数 时 候 还 是 
值得 一 拼 的 , 不 允许 任何 人 让 系统 变 得 更 糟 。 不 值得 这 么 做 的 唯一 情况 是 , 你 面 对 的 是 一 个 封闭 
的 系统 或 即将 被 淘汰 的 系统 。 




































































8.3 法 则 


我 们 将 看 到 一 个 增 量 地 改善 遗留 代码 库 的 示例 。 你 会 学 到 许多 特别 的 技巧 , 每 一 个 技巧 都 是 
为 手头 上 特定 的 问题 量 身 定制 的 。 这 些 技巧 是 在 《修改 代码 的 艺术 》 及 其 他 地 方 提 到 的 几 十 个 技 
巧 的 一 个 子 集 。 你 会 发 现 这 些 技巧 简单 易学 ,并 且 一 旦 学 会 少量 的 技巧 ， 就 可 以 推导 出 剩 下 的 许 
多 技巧 。 

处 理 遗 留 代码 问题 的 核心 法 则 如 下 。 


a 任何 时 候 ， 只 要 可 以 就 进行 测试 驱动 。 使 用 测试 驱动 方法 时 ， 有 可 能 的 话 就 将 需要 改动 
的 代码 作为 新 的 成 员 或 新 的 类 。 



























































口 不 要 让 测试 覆盖 率 缩水 。 非 常 容易 出 现 的 情况 是 ， 改 动 一 点 代码 ， 然 后 认为 这 只 是 一 些 
简单 的 代码 行 ， 并 对 之 不 予 过 多 考虑 。 如 果 没 有 测试 ， 每 一 行 新 加 的 代码 都 会 导致 测试 
DE ES 

















a 为 了 编写 测试 ， 必 须 改动 现 有 代码 ! 由 于 对 协作 对 象 的 依赖 ， 大 多 数 情况 下 不 能 方便 地 
为 遗留 代码 编写 测试 。 在 编写 测试 前 ， 需 要 一 个 打破 依赖 的 方法 。 

a 可 以 在 限制 范围 内 实施 微小 的 代码 改动 ， 这 样 会 降低 风险 。 用 一 些 技巧 就 可 以 手动 地 做 
出 一 些小 而 安全 的 代码 变换 "。 

O 你 编写 的 每 行 代码 都 有 风险 ， 甚 至 一 个 敲 错 的 字符 都 会 引入 洪 在 的 缺陷， 而 这 可 能 会 浪 
费 好 几 个 小 时 。 尽 可 能 少 写 代 码 ， 每 襄 击 一 次 键盘 时 都 要 想 清楚 。 

O 坚持 小 的 、 增 量 的 改动 。 这 在 TDD 中 是 奏效 的 。 同 样 ， 对 遗留 代码 也 是 如 此 。 步 子 迈 得 
太 大 会 使 你 陷入 困境 。 

口 一 次 只 做 一 件 事 。 在 处 理 遗 留 代码 时 ， 不 要 合并 步骤 或 目标 。 例 如 ， 不 要 在 重 构 的 同时 




































































CD 代码 变换 不 同 于 代码 重 构 。 





译 者 注 








84 sU emm 167 





写 测试 。 

口 有 些 增 量 的 改动 可 能 会 使 代码 变 得 丑陋 ， 要 接受 这 一 点 。 记 住 ， 一 次 只 做 一 件 事 。 可 能 
需要 几 个 小 时 做 “正确 ”的 事 。 不 要 等 ， 现 在 就 提交 工作 方案 ， 因 为 这 样 或 许 就 不 用 花 
费 过 多 时 间 。 
同时 ， 不 要 过 于 担心 会 违反 一 些 设 计 原 则 。 最 终 ， 你 可 能 要 抽出 时 间 回 过 头 来 整理 代码 ， 
或 许 你 不 会 ， 但 依然 是 进步 了 。 你 已 经 向 正确 的 方向 迈进 了 ， 而 且 也 证 明了 所 有 代码 依 
然 可 以 工作 。 

O 增 量 地 修改 代码 。 面 对 庞大 的 代码 库 时 ,仅仅 为 遇 到 的 相关 代码 编写 测试 或 许 不 能 带 来 
巨大 改观 。 更 重要 的 是 你 内 心 深 知 任何 新 加 入 的 东西 都 需要 经 过 测试 。 

秉承 测试 第 一 的 心态 ， 你 会 开始 从 加 入 的 测试 中 获 益 。 每 通过 一 个 测试 ， 可 以 回顾 一 下 

测试 覆盖 的 代码 区 域 。 几 乎 总 能 发 现 做 一 些小 的 、 安 全 的 重 构 工 作 的 机 会 。 同 时 ， 你 也 

会 发 现在 写 完 一 个 测试 后 ， 再 写 一 个 是 如 此 容易 。 你 可 以 在 各 个 地 方 应 用 这 种 小 的 改善 

步伐 而 丝毫 不 影响 产 出 ， 也 将 在 困难 重重 的 代码 库 中 如 履 平 地 。 









































8.4 遗留 应 用 程序 


场景 : WAV Snippet Publisher 
作为 一 个 内 容 转 销 商 ， 我 想 要 WAV Snippet Publisher 从 一 个 源 文 件 目 录 下 的 每 个 
WAV 文 件 中 抽出 一 段 ， 然 后 生成 一 个 新 的 WAV 文 件 ， 并 保存 在 目标 目录 下 。 


音频 ( Waveform Audio, WAV ) 文件 标准 出 自 于 Microsoft 和 IBM， 这 基于 他 们 的 Resource 
Interchange File Format ( RIFF )， 参 见 http:/en.wikipedia.org/wiki/WAV。WAV 文 件 包 含 音 频数 据 ， 
这 些 数据 被 编码 成 一 个 样本 集合 ,通常 用 被 广泛 接受 的 脉冲 码 调制 ( Pluse-Code Modulation, PCM ) 
标准 ， 参 见 http:/en.wikipedia.org/wiki/Pulse-code modulation, 。 可 以 在 https:Wccrma.stanford.edu/ 
courses/422/projects/WaveFormat/ 找 到 WAV 格 式 的 一 个 简化 版 。 


虽然 实现 上 有 诸多 限制 , 但 Snippet Publisher 还 是 能 够 满足 现 有 需求 , 但 客户 的 需求 是 不 断 提 
高 的 。 例 如 ， 它 不 能 处 理 音频 样本 为 奇数 的 情形 ， 也 不 能 处 理 多 通道 WAV 文 件 。 由 于 小 端 /大 端 
的 差异 , 它 也 不 能 文 持 所 有 的 平台 。 客 户 要 求 我 们 除 掉 这 些 限 制 ( 这 些 留 给 读者 用 作 以 后 的 练习 )。 



























































场景 : 添加 多 通道 的 支持 
目前 ，Snippet publisher 仅 能 处 理 单 通道 WAV 文 件 。 作 为 内 容 转 销 商 ， 要 确保 立体 
声效 的 WAV 片 段 不 会 被 中 途 截 断 。 
啊 ! 已 经 有 变化 了 ! 不 幸 的 是 , Snippet Publisher 几 乎 没有 单元 测试 , 但 这 也 在 预料 之 中 。( 在 
为 本 章 准 备 时 , 我 没有 采用 TDD 来 构建 代码 库 。 起 初速 度 似乎 比较 快 , 但 由 于 缺乏 测试 ,花费 的 
时 间 很 快 就 比 之 前 节省 的 时 间 还 要 和 多。 ) 
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open () 函数 包含 了 一 大 堆 WAV Snippet Publisher 处 理 逻 辑 。 接 下 来 的 几 页 都 是 。 


wav/1/WavReader.cpp 


void WavReader::open(const std::string& name, bool trace) { 
rLog(channel, "opening *ss", name.c str()); 


ifstream file(name, ios::in | ios::binary); 

if (!file.is open()) { 
rLog(channel, "unable to read %s", name.c str()); 
return; 


ofstream out(dest + "/" + name, ios::out | ios::binaryj; 


RiffHeader header; 
file.read(reinterpret cast«char*»(&header), sizeof(RiffHeader)); 


if (toString(header.id, 4) != "RIFF") ( 
rLog(channel, "ERROR: %s is not a RIFF file", 
name.c str()); 


return; 
} 
if (toString(header.format, 4) != "WAVE") { 
rLog(channel, "ERROR: %s is not a wav file: %s", 
name.c_str(), 
toString(header.format, 4).c_str()); 
return; 
} 


out.write(reinterpret_cast<char*>(&header), sizeof(RiffHeader)); 


FormatSubchunkHeader formatSubchunkHeader; 
file.read(reinterpret cast«char*»(&formatSubchunkHeader), 
sizeof(FormatSubchunkHeader)) ; 


if (toString(formatSubchunkHeader.id, 4) !- "fmt ") ( 
rLog(channel, "ERROR: %s expecting 'fmt' for subchunk header; got '%s'", 
name.c str(), 
toString(formatSubchunkHeader.id, 4).c str()); 
return; 


} 


out.write(reinterpret_cast<char*>(&formatSubchunkHeader), 
sizeof(FormatSubchunkHeader)) ; 


FormatSubchunk formatSubchunk; 
file.read(reinterpret cast«char*-(&formatSubchunk), sizeof(FormatSubchunk)); 


out.write(reinterpret cast«char*-(&formatSubchunk), sizeof(FormatSubchunk)); 


rLog(channel, "format tag: *u", formatSubchunk.formatTag); // 显示 十 六 进 制 文件 ? 
rLog(channel, "samples per second: %u", formatSubchunk.samplesPerSecond); 
rLog(channel, "channels: %u", formatSubchunk.channels); 

rLog(channel, "bits per sample: *su", formatSubchunk.bitsPerSample); 


8&4 uU em«m 169 





VYVYVYVYVYVYYYN 


// 


auto bytes - formatSubchunkHeader.subchunkSize - sizeof(FormatSubchunk) 


auto additionalBytes - new char[bytes]; 
file.read(additionalBytes, bytes); 
out.write(additionalBytes, bytes); 


FactOrData factOrData; 
file.read(reinterpret cast«char*-(&factOrData), sizeof(FactOrData)); 
out.write(reinterpret cast«char*-(&factOrData), sizeof(FactOrData)); 


if (toString(factOrData.tag, 4) == "fact") ( 
FactChunk factChunk; 
file.read(reinterpret cast«char*»(&factChunk), sizeof(FactChunk)); 
out.write(reinterpret cast«char*-(&factChunk), sizeof(FactChunk)); 


file.read(reinterpret cast«char*»(&factOrData), sizeof(FactOrData)); 
out.write(reinterpret cast«char*-(&factOrData), sizeof(FactOrData)); 


rLog(channel, "samples per channel: %u", factChunk.samplesPerChannel); 


} 

if (toString(factOrData.tag, 4) != "data") { 
string tag(toString(factOrData.tag, 4)}; 
rLog(channel, "%s ERROR: unknown tag»*ss«", name.c str(), tag.c str()); 
return; 

} 


DataChunk dataChunk; 
file.read(reinterpret cast«char*-(&dataChunk), sizeof(DataChunk)); 


rLog(channel, "riff header size = *u" , sizeof(RiffHeader)); 
rLog(channel, "subchunk header size = %u", sizeof(FormatSubchunkHeader)); 
rLog(channel, "subchunk size = %u", formatSubchunkHeader.subchunkSize); 
rLog(channel, "data length = %u", dataChunk. length); 


// TODO: 如果 对 这 里 有 一 个 填充 字 节 感到 奇怪 ! 
auto data = new char[dataChunk. Length] ; 
file.read(data, dataChunk.length); 
file.close(); 


// 所 有 这 些 

out.write(data, dataChunk. length); 
// TODO: 多 个 通道 
uint32 t secondsDesired{10}; 
if (formatSubchunk.bitsPerSample == 0) formatSubchunk.bitsPerSample = 8; 
uint32 t bytesPerSample([formatSubchunk.bitsPerSample / uint32 t{8}}; 
uint32 t samplesToWrite([secondsDesired * formatSubchunk.samplesPerSecond]; 
uint32 t totalSamples(dataChunk.length / bytesPerSample); 


samplesToWrite = min(samplesToWrite, totalSamples); 


uint32 t totalSeconds[totalSamples / formatSubchunk.samplesPerSecond]; 
rLog(channel, "total seconds %u ", totalSeconds); 
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Yvy 


dataChunk. length = samplesToWrite * bytesPerSample; 
out.write(reinterpret_cast<char*>(&dataChunk), sizeof(DataChunk)); 


uint32_t startingSample{ 
totalSeconds >= 10 ? 10 * formatSubchunk.samplesPerSecond : 0}; 
rLog(channel, "writing %u samples", samplesToWrite); 
for (auto sample - startingSample; 
sample < startingSample + samplesToWrite; 
SampLe++) { 
auto byteOffsetForSample = sample * bytesPerSample; 
for (uint32 t byte{0}; byte < bytesPerSample; byte++) 
out.put(data[byteOffsetForSample + byte]); 


VYVYVVYVYVYYYN 


j 
rLog(channel, "completed writing %s", name.c str()); 
descriptor -»-add(dest , name, 
totalSeconds, formatSubchunk.samplesPerSecond, formatSubchunk.channels); 
out.close(); 


) 

open () 函数 里 有 注释 、to-do、 注 释 掉 的 处 理 逻 辑 、 有 问题 的 命名 、 魔 数 、 重 复 代码 ， 以 及 能 
解决 所 有 问题 的 一 站 式 代 码 。 还 有 什么 不 喜欢 的 ? 

好 吧 , 我 们 不 是 很 喜欢 这 段 代码 。 在 尝试 加 入 多 通道 的 支持 时 , 若 基于 这 样 错 综 复 杂 的 代码 ， 
把 事情 搞 磺 的 概率 是 很 高 的 。 为 所 要 改动 的 代码 加 上 测试 有 助 于 添加 多 通道 的 支持 。 


8.5 保持 测试 驱动 开发 的 心态 


在 应 对 遗留 代码 时 依然 是 测试 先行 。 即 使 已 经 编写 完 测 试 所 涵盖 的 代码 , 仍 需要 写 测试 来 描 
述 已 有 行为 的 特征 。 同 时 ， 也 要 以 TDD 的 方式 添加 新 代码 。 

你 可 能 会 意识 到 在 事实 发 生 后 编写 测试 (有 时 候 我 称 之 为 开发 后 测试 ， 即 Test-After- 
Development, TAD ), 会 比 用 TDD 编 写 代 码 更 花费 精力 。 究 其 主要 原因 是 ， 如 果 程 序 员 不 考虑 测 
iX, 那 他 们 就 不 会 用 易于 测试 的 方式 组 织 代码 ; 在 TDD 过 程 中 , 应 该 持续 地 重 构 , 使 代码 元 素 " 趋 
于 更 小 化 、 更 具 可 重用 性 ， 这 有 助 于 更 容易 地 编写 新 的 测试 和 代码 。 

测试 open( ) 函数 看 上 去 可 能 非常 耗 时 。 我 们 需要 创建 或 找到 一 个 甚至 多 个 WAV 文 件 以 便 测 
试 之 用 ， 也 要 读 取 结 果 文 件 并 检查 其 内 容 。 目 前 我 们 没有 时 间 处 理 这 些 细 节 。 

生活 可 以 更 简单 。 只 需要 测试 即将 被 改动 的 代码 , 参考 底线 会 告诉 你 什么 时 候 破 坏 了 已 有 的 
行为 。 虽 然 你 要 判定 出 哪些 依赖 代码 可 能 会 因此 被 破坏 ,但 不 需要 测试 超出 改动 范围 的 代码 。 

同时 , 要 避免 那些 必须 与 文件 系统 直接 打交道 的 测试 ,以 便 保持 测试 集 快速 运行 并 减少 管理 
文件 的 烦恼 。 尽 量 使 用 存储 于 内 存 的 流 而 非 文 件 流 ， 这 样 可 以 部 分 达成 效果 。 















































































































































中 这 





有 的 代码 元 素 主 要 指 一 段 逻 辑 内 聚 的 代码 ， 从 前 文 可 以 看 出 ， 将 这 些 代码 提炼 为 小 方法 是 一 个 很 好 的 实践 。 
一 一 译 者 注 





8.66 支持 测试 的 安全 重 构 171 





8.6 支持 测试 的 安全 重 构 

为 了 开始 增加 对 多 通道 的 支持 ， 先 找 出 open ( ) 函数 中 有 用 的 功能 验证 点 吧 ! 

函数 的 末尾 似乎 有 一 系列 计算 一 一 总 秒 数 、 要 写 出 的 采样 数目 、 开 始 的 地 方 ， 等 等 。 紧 接着 
计算 的 是 一 个 for 循 环 ， 看 上 去 要 将 采样 写 和 输出 文件 中 〈 这 段 代 码 在 前 面 的 open C) 函数 代码 列 
表 中 被 标记 出 来 了 )。 需 要 改变 一 两 个 计算 部 分 并 修改 循环 来 支持 多 通道 。 

最 有 趣 的 代码 是 循环 。 我 们 来 给 它 编写 一 些 测试 吧 .…… 但 是 怎样 编写 呢 ? 为 了 达到 open () 
函数 的 这 个 点 ， 我 们 需要 配置 大 量 的 信息 。 

与 之 相反 ， 将 循环 代码 隔离 出 来 ， 放 进 一 个 成 员 函 数 中 ， 然 后 直接 测试 即 可 。 

































































提问 : 要 改动 代码 了 吗 ? 是 不 是 有 破坏 代码 的 风险 ? 

回答 : 是 的 。 为 了 履 盖 必须 修改 的 代码 ， 我 们 需要 添加 测试 。 将 一 段 代 码 提 取 成 一 
个 方法 是 我 们 可 以 采取 的 比较 安全 的 代码 变化 方法 。 

提问 : 提取 出 一 个 函数 ， 并 将 函数 原型 放 进 头 文件 会 增加 工作 量 。 有 没有 更 容易 的 
方法 呢 ? 

回答 : 目前 最 简单 的 方法 是 方法 提取 。 用 测试 覆盖 open( ) 函数 的 前 半 部 分 需要 数 
小 时 。 

提问 : 我 现在 理解 并 接受 了 为 什么 可 测试 的 代码 更 好 。 但 是 你 将 方法 声明 为 公有 的 ， 
许多 资深 程序 员 都 会 部 视 这 样 的 做 法 。 

回答 : 如 果真 的 需要 ， 可 以 采用 其 他 稍微 保守 点 的 技巧 。 例 如 ， 可 以 将 方法 定义 为 
受 保 护 的 ,创建 一 个 派生 的 测试 ， 将 其 定义 为 公有 的 。 这 需要 许多 额外 的 工作 量 和 维护 
成 本 ， 而 收益 甚 微 。 我 倾向 于 更 简单 的 方法 。 

提醒 你 的 同事 ， 知 道 代 码 正 常 工 作 更 重要 ， 不 要 为 了 不 大 可 能 出 现 的 、 随 意 暴 露 代 
码 的 行为 杞 人 忧 天 。 

同时 ,可 以 写 一 些 审慎 的 注释 ,解释 暴露 函数 的 原因 来 缓解 他 们 的 不 安 。 将 成 员 暴 
露出 来 突显 出 了 设计 上 的 缺陷 一 依恋 情结 (feature envy" )。 成 员 暴 露 后 会 迫使 一 些 人 
修复 这 个 设计 问题 。 
这 种 函数 提取 方法 会 以 小 而 机 械 的 步骤 完成 。 
(1) 先 在 待 提 取 函 数 的 地 方 录入 函数 调用 。 





wav/2/WavReader.cpp 


uint32 t startingSample( 
totalSeconds »- 10 ? 10 * formatSubchunk.samplesPerSecond : 0j; 











(D feature envy 是 众多 代码 坏 味 中 的 一 个 ， 它 违背 了 将 数据 和 其 操作 封装 在 一 起 的 原则 。 参 见 《 重 构 》 一 书 。 
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» writeSamples(out, data, startingSample, 


rLog(channel, "writing %u samples", 
for (auto sample startingSample; 


samplesToWrite, bytesPerSample); 


samplesToWrite); 


sample < startingSample + samplesToWrite; 


sample--) 1 
auto byteOffsetForSample 
for (uint32 t byte(0); byte < bytesPe 
out.put(data[byteOffsetForSample + 


} 

rLog(channel, "completed writing *ss", 

descriptor -»-add(dest , name, 
totalSeconds, 


formatSubchunk.samplesPerSecond, 


sample * bytesPerSample; 


rSample; 
byte]); 


byte++) 


name.c str()); 


formatSubchunk. channels); 





(2) 在 open() 
日 通过 编译 , 就 将 























函数 前 加 入 相应 的 函数 声明 ， 
其 从 文件 头 部 移 除 ) 补 全 


简单 地 从 代码 中 的 函数 调用 复制 /粘贴 即 可 。( 一 
函数 的 返回 值 类 型 ( void ) 和 函数 体 大 括号 。 有 目前 先 














使 函数 保持 自由 ， 这 样 在 得 到 正确 参数 前 ， 就 不 用 在 代码 原型 中 重复 此 动作 。 
wav/2/WavReader.cpp 
void writeSamples(out, data, startingSample, samplesToWrite, bytesPerSample) { 


} 





(3) JywriteSamples () 的 参数 加 上 类 





时 参数 是 和 否 能 与 函数 声明 匹配 ， 然 后 修复 编 ; 
) 的 实现 限定 在 类 内 ( WavReader:: )。 


WavReader.h 中 ， 并 将 writeSamples( 


wav/3/WaveReader.cpp 


void WavReader: 
uint32 t startingSample, 
uint32 t samplesToWrite, 
uint32 t bytesPerSample) ( 


wav/3/WavReader.h 


public: 
// aan 
void writeSamples(std: 
uint32 t startingSample, 
uint32 t samplesToWrite, 
uint32 t bytesPerSample); 


(4) 将 for 循 环 移 至 writeSamptLes ( 
传人 必要 的 参数 。 


wav/4/WavReader.cpp 


void WavReader: 
uint32 t startingSample, 
uint32 t samplesToWrite, 
uint32 t bytesPerSample) ( 


:writeSamples(ofstream& out, 


:ofstream& out, 


) 内 ， 


:writeSamples(ofstream& out, 




















型 信息 。 利 用 编译 右 就 能 得 知 ， 调 用 writeSamples() 
圣 器 指出 的 地 方 。 一 切 完 成 后 ， 将 函数 原型 写 进 


























char* data, 


char* data, 


ea 








并 确保 编译 有 可 能 会 





译 失 败 ， 例 如 ， 忘 





























char* data, 
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rLog(channel, "writing %i samples", samplesToWrite); 


for (auto sample - startingSample; 
sample < startingSample + samplesToWrite; 
sample++) { 
auto byteOffsetForSample = sample * bytesPerSample; 
for (uint32 t byte{0}; byte < bytesPerSample; byte++) 
out.put(data[byteOffsetForSample + bytel); 
} 
} 


Te open () 成 员 函 数 中 的 for 循 环 。 


wav/4/WavReader.cpp 


uint32 t startingSample( 
totalSeconds >= 10 ? 10 * formatSubchunk.samplesPerSecond : 


0}; 


> writeSamples(out, data, startingSample, samplesToWrite, bytesPerSample); 


rLog(channel, "completed writing %s", name.c str()); 


descriptor --add(dest , name, 


totalSeconds, formatSubchunk.samplesPerSecond, formatSubchunk.channels); 


接 下 来 编译 并 运行 已 有 的 测试 。 我 们 已 经 成 功 并 安全 地 将 
writeSamples() 函数 也 会 增强 open( ) 函数 的 抽象 度 。 























一 段 代码 提取 为 函数 了 。 提 取 





有 时 , 在 尝试 提取 函数 时 会 遇 到 环 手 的 编译 错误 。 如 果 你 觉得 必须 要 改变 代码 才能 使 编译 通 


过 , 多 半 是 因为 提取 了 错误 的 代码 。 停 下 来 重新 思考 一 下 使 用 的 方法 。 可 以 改变 提取 代码 的 范围 ， 


或 先 找到 写 更 多 测试 的 方法 。 

















每 从 已 有 代码 中 复制 一 次 就 会 引入 重复 代码 。 因 此 ， 许 多 测试 驱动 开发 者 认为 复制 /粘贴 是 





“ 那 恶 的 ”方法 。 在 编写 新 代码 时 ， 应 当 维护 记录 每 次 粘贴 的 栈 ， 
复 代 码 来 弹 清 此 栈 。 
































并 要 记得 通过 重 构 掉 所 有 的 重 














就 遗留 代码 来 说 ， 复 制 /粘贴 通常 是 很 好 的 方法 。 在 操作 已 有 代码 时 ， 最 小 化 实际 的 编码 量 ， 
从 已 有 的 结构 中 复制 可 以 降低 犯 低 级 错误 的 风险 。 这 里 所 采取 的 提取 writeSamptLes ( ) 的 步 又 ( 只 
展现 了 一 种 可 行 的 方法 ) 最 小 化 了 代码 输入 量 、 最 大 化 了 编译 器 帮助 抓 住 错误 的 能 


我 们 没有 改变 writeSamptes0O 中 的 任何 代码 。 这 就 意味 着 唯一 的 风险 在 于 是 否 正确 地 调用 了 








函数 。( 如 果 函 数 不 返回 空 , 还 要 确保 正确 地 处 理 了 返回 值 。) A05 
也 就 不 用 为 之 编写 测试 。 相 反 ， 我 们 将 围绕 传 给 writeSamptLes( 
文中 做 这 件 事 。 





不 特意 修改 writeSampLes ()， 
) 的 参数 编写 测试 。 我 们 会 在 后 
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8.7 ”添加 测试 刻画 已 有 行为 
我 们 需要 改动 writesamples() 中 的 代码 。 从 一 些 测试 开始 吧 ! 


wav/6/WavReaderTest.cpp 

#include "CppUTest/TestHarness.h" 
#include "WavReader.h" 

#include <iostream> 

#include <string> 

#include <sstream> 


using namespace std; 


TEST GROUP (WavReader WriteSamples) 
1 
WavReader reader("",""3; 
ostringstream out; 


H 


TEST(WavReader WriteSamples, WritesSingleSample) { 
char data[] ( "abcd" }; 
uint32 t bytesPerSample ( 1 }; 
uint32 t startingSample { 0 j; 
uint32 t samplesToWrite ( 1 }; 
reader.writeSamples(&out, data, startingSample, samplesToWrite, bytesPerSample); 
CHECK EQUAL("a", out.str()); 
} 


TEST(WavReader WriteSamples, WritesMultibyteSampleFromMiddle) { 
char data[] ( "0123456789ABCDEFG" }; 
uint32 t bytesPerSample ( 2 }; 
uint32 t startingSample ( 4 }; 
uint32 t samplesToWrite ( 3 }; 


reader.writeSamples(&out, data, startingSample, samplesToWrite, bytesPerSample); 
CHECK EQUAL("89ABCD", out.str()); 
} 
针对 writeSamptLes () 的 测试 有 助 于 我 们 单独 理解 循环 的 行为 。 而 且 ， 测 试 也 不 是 很 大 。 需 
要 仔细 阅读 WriteMultibyteSampleFromMiddle 测 试 ， 并 要 求 掌握 一 点 点 数学 知识 。 怎 样 能 使 之 变 
得 更 直观 呢 ? 


为 了 避免 使 用 实际 文件 而 降低 测试 速度 ,我 们 使 用 快速 的 、 存 储 于 内 存 的 字符 串 对 象 ， 其 类 
型 为 std::ostringstream 。 这 就 要 修改 writeSamptLes() 的 接口 ， 使 其 接受 std::ostream 对 象 ， 
std::ofstream 利 std::ostringstream 都 继承 自 这 个 类 型 。 更 确切 地 说 ， 我 们 修改 接口 以 便 其 接受 一 个 
指向 std::ostream 的 指针 。 产 品 代码 可 以 传递 文件 流 的 地 址 ; 测试 则 可 以 传递 字符 串 流 的 地 址 。 改 
变 writeSamples() 中 使 用 局 部 变量 out 的 解 引 用 方式 ， 使 其 使 用 指针 语义 。 
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wav/6/WavReader.cpp 


writeSamples(&out, data, startingSample, samplesToWrite, bytesPerSample); 


wav/6/WavReader.cpp 


» void WavReader::writeSamples(ostream* out, char* data, 
uint32 t startingSample, 
uint32 t samplesToWrite, 
uint32 t bytesPerSample) { 
rLog(channel, "writing %i samples", samplesToWrite); 


for (auto sample - startingSample; 
sample < startingSample + samplesToWrite; 
SampLe++) { 
auto byteOffsetForSample = sample * bytesPerSample; 
for (uint32 t byte(0); byte < bytesPerSample; byte++) 
» out-»-put(data[byteOffsetForSample + byte]); 


8.8 被 遗留 代码 转移 注意 力 


测试 集 失 败 了 ! 对 于 每 个 测试 ，CppUTest 将 执行 开始 和 执行 结束 后 的 内 存 对 比 ， 如 果 发 现 
不 匹配 就 报 失败 。 稍 微 考察 一 下 代码 ， 我 们 发 现 ， 内 存 泄漏 问题 的 根源 要 么 出 在 第 三 方 日 志 库 
rlog， 要 么 出 在 WavReader 对 rlog 的 使 用 上 。 处 理 内 存 泄漏 不 是 主要 目的 。 我 们 需要 找 出 一 条 路 
继续 前 行 。 

CppUTest 允 许 我 们 关闭 内 存 泄 漏 检 测 , 但 这 是 一 个 非常 有 用 的 功能 ,值得 人 保留。 此外， 就算 
关闭 内 存 泄漏 检测 ， 每 次 运行 测试 时 ， 贯 穿 WavReader 代 码 之 间 的 日 志 代 码 也 会 向 控制 台 发 送 消 
E, 这 是 十 分 令 人 讨厌 的 。 除了 默默 忍受 还 有 其 他 办 法 吗 ? 在 不 修改 代码 的 前 提 下 关 掉 日 志 也 是 
可 行 的 ,但 已 经 没有 时 间 了 ， 我 们 需要 继续 前 行 。 

第 三 方 库 会 为 测试 制造 无 尽 的 烦恼 。 它 们 要 么 速度 慢 , 要 么 需要 大 量 的 配置 工作 , 还 可 能 
副作用 。 如 果 你 是 第 一 次 面 对 遗 留 代码 , 很 有 可 能 会 花费 大 量 时 间 以 处 理 来 自 第 三 方 库 导 致 的 类 
似 问题 。 

规避 第 三 方 库 的 一 个 可 行 方法 是 链接 替换 。 就 WavReader 应 用 而 言 ， 我 们 将 创建 一 个 包含 存 

T PECES P, 这 些 函 数 对 应 rlog 中 的 每 个 函数 ,在 构建 应 用 可 执行 文件 时 , 我 们 会 链接 到 这 个 库 。 


链接 替换 ， 或 链接 期 替换 ， 听 上 去 比 做 起 来 难得 多 ， 但 其 实 可 以 很 快 建立 。 
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不 需要 为 rlog 库 中 定义 的 每 个 函数 生成 存根 函数 ， 只 需 定义 测试 需要 的 。 我 们 开始 注释 掉 
makefile 中 的 一 些 命令 行 , 这 个 makefile 将 rlog 和 测试 可 执行 文件 链接 起 来 。 下 面 是 对 CMakeLists.txt 
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的 更 新 〈 我 们 使 用 CMake )。 


TR. 


wav/7/CMakeLists.txt 


project(SnippetPublisher) 
cmake minimum required(VERSION 2.6) 


include directories($ENV(BOOST ROOT}/ $ENV(RLOG HOME) $ENV(CPPUTEST HOME) /include) 
link directories($ENV(RLOG HOMEj?/rlog/.libs $ENV(CPPUTEST HOME)/lib) 
set(Boost USE STATIC LIBS ON) 


add definitions(-std-ce«0x) 


Set(CMAKE CXX FLAGS "$(CMAXE CXX FLAGS) -DRLOG COMPONENT-debug -Wall") 
set(sources WavReader.cpp WavDescriptor.cpp) 

set(testSources WavReaderTest.cpp) 

add executable(utest testmain.cpp $[testSources) $[sources]) 

add executable(SnippetPublisher main.cpp $í(sources]) 


find package(Boost $ENV(BOOST VERSION) COMPONENTS filesystem system) 
target link libraries(utest $(Boost LIBRARIES]) 

target link libraries(utest CppUTest) 

target link libraries(utest pthread) 

target link libraries(utest rt) 

target link libraries(utest rlog) 


target link libraries(SnippetPublisher $(Boost LIBRARIES)) 
target link libraries(SnippetPublisher pthread) 
target link libraries(SnippetPublisher rlog) 


在 构建 时 ， 我 们 发 现 了 许多 链接 错误 。 


Linking CXX executable utest 

CMakeFiles/utest.dir/WavReader.cpp.o: In function "WavReader::WavReader( 
std::string const&, std::string const&)': 

WavReader.cpp:(.text«Oxef): undefined reference to 
"rlog::StdioNode::StdioNode(int, int)' 

WavReader.cpp:(.text«0x158): undefined reference to 
"rlog::GetComponentChannel(char const*, char const*, rlog::LogLevel)' 

WavReader.cpp:(.text«0x17c): undefined reference to 
"rlog::GetComponentChannel(char const*, char const*, rlog::LogLevel)' 

WavReader.cpp:(.text«0x18e): undefined reference to 
" rlog::StdioNode::subscribeTo(rlog::RLogNode*) ' 

WavReader.cpp:(.text«0x1le4): undefined reference to 
"rlog::PublishLoc::-PublishLoc()' 








需要 为 链接 到 rlog 的 每 个 函数 提供 存根 。 以 下 是 一 个 方法 。 
(1) 将 rlog 的 头 文件 复制 进 一 个 子 目 录 ， 将 其 重 命名 为 一 个 .cpp 文 件 。 














(2) 编辑 这 个 .cpp 文 件 , 如 果 需 要 返回 一 个 默认 的 返回 值 , 那么 就 可 以 将 函数 原型 变 为 一 个 存 





























(3) 编译 并 重复 上 述 两 个 步骤 ， 直 到 消除 所 有 的 链接 错误 。 
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CH 


由 于 StdioNode 出 现在 链接 错误 列表 的 第 一 个 ， 我 们 就 从 它 开始 1 


wav/8/StdioNode.cpp 
#include <rlog/StdioNode.h> 


class RLogNode; 
class RLogData; 


using namespace std; 


namespace rlog { 
StdioNode::StdioNode(int fdOut, int flags) 
: RLogNode() {} 
StdioNode::StdioNode(int fdOut, bool colorizeIfTTY) 
: RLogNode(), fdOut( fdOut ) ( } 
StdioNode::-StdioNode() ( } 
void StdioNode::subscribeTo( RLogNode *node ) { } 
void StdioNode::publish( const RLogData &data ) { } 
} 
这 不 是 太 难 ， 但 是 将 头 文件 转 为 实现 文件 可 能 会 让 人 感到 乏味 ， 而 且 有 时 候 有 点 棘手 。( 或 
许 有 一 个 很 棒 的 工具 能 够 帮助 你 做 这 些 工作 ! ) 下 面 是 一 些 需 要 考虑 的 事情 〈 不 是 所 有 的 事情 )。 


口 首先 需要 做 的 是 ， 包 含 所 创建 的 实现 文件 的 地 方 头 文件 。 

a 可 能 需要 将 实现 文件 放 在 一 个 命名 空间 中 。 

a 移 除 virtual 和 static 关 键 字 。 

Q 移 除 public: 和 其 他 一 些 访 问 修饰 符 。 

口 移 除 成 员 变 量 和 枚 举 值 。 

口 在 移 除 预 处 理 定 义 和 typedefs 时 要 小 心 。 

口 如 果 函 数 有 返回 值 ， 就 返回 一 个 最 简单 的 ， 如 0、false、""、 空 指针 或 一 个 无 参 构造 函数 
构造 的 实例 。 
Q 如 果 必 须要 返回 一 个 const 引 用 ,创建 一 个 全 局 变量 ， 并 返回 这 个 变量 。 
口 不 要 忘记 将 函数 限定 在 合适 的 类 。 

口 不 要 太 注 重 外 观 ， 重 要 的 是 能 够 编译 。 


添加 一 个 构建 新 存根 库 的 makefile。 



















































































wav/8/rlog/CMakeLists.txt 


project(rlogStub) 
cmake minimum required(VERSION 2.6) 


include directories($ENV(RLOG HOME}) 
add_definitions (-std=c++0x) 


Set(CMAKE CXX FLAGS "${CMAXE_CXX_FLAGS} -DRLOG COMPONENT-debug -Wall") 
set(sources StdioNode.cpp) 
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add library(rlogStub ${sources}) 


target link libraries(rlogStub pthread) 


接 下 来 ， 更 新 测试 构建 脚本 以 便 使 用 存根 库 。 而 产品 应 用 SnippetPublisher 继 续 使 用 产品 级 的 
rlog 库 。 











wav/8/rlog/CMakeLists.txt 


project(SnippetPublisher) 
cmake minimum required(VERSION 2.6) 


include directories($ENV(BOOST ROOT}/ $ENV(RLOG HOME) $ENV(CPPUTEST HOME) /include) 
link directories($ENV(RLOG HOMEj?/rlog/.libs $ENV(CPPUTEST HOME)/lib) 
set(Boost USE STATIC LIBS ON) 


» add subdirectory(rlog) 
add definitions(-std-ce«0x) 


Set(CMAKE CXX FLAGS "$(CMAXE CXX FLAGS) -DRLOG COMPONENT-debug -Wall") 
set(sources WavReader.cpp WavDescriptor.cpp) 

set(testSources WavReaderTest.cpp) 

add executable(utest testmain.cpp $[testSources) $[sources]) 

add executable(SnippetPublisher main.cpp $í(sources]) 


find package(Boost $ENV(BOOST VERSION) COMPONENTS filesystem system) 
target link libraries(utest $(Boost LIBRARIES]) 
target link libraries(utest CppUTest) 
target link libraries(utest pthread) 
» target link libraries(utest rlogStub) 


target link libraries(SnippetPublisher ${Boost LIBRARIES)) 
target link libraries(SnippetPublisher pthread) 
target link libraries(SnippetPublisher rlog) 


构建 基于 StdioNode.h 的 存根 失败 了 。 我 们 为 RLogChannle.h、RLogNode.h 和 rlog.h 添 加 
了 存根 ， 它 们 都 是 实现 rlog 库 的 头 文件 。 下 面 是 RLogChannetL .h 的 存根 实现 ， 因 为 需要 提供 返回 
值 ， 所 以 稍微 有 趣 点 。 








wav/9/rlog/RLogChannel.cpp 
#include "rlog/RLogChannel.h" 
#include «string» 

include <iostream> 


namespace rlog 


1 

RLogChannel::RLogChannel( const std::string &name, LogLevel level )í( } 
RLogChannel: :-RLogChannel()1() 

void RLogChannel::publish(const RLogData &data){} 


std::string nameReturn(""); 
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const std::string &RLogChannel::name() const ( return nameReturn; } 


LogLevel RLogChannel::logLevel() const ( return LogLevel(); } 
void RLogChannel::setLogLevel(LogLevel level) {} 
RLogChannel *getComponent(RLogChannel *componentParent, 

const char *component)( return 0; } 


} 
我 们 一 次 只 创建 一 个 存根 ， 同 时 记 住 ， 要 更 新 每 个 makefile 文 件 。 








wav/9/rlog/CMakeLists.txt 
set(sources rlog.cpp RLogChannel.cpp RLogNode.cpp StdioNode.cpp) 


尝试 构建 已 有 的 新 存根 。 在 准备 好 4 个 存根 后 ， 链 接 和 测试 成 功 了 ! 大 概 需要 20 分 钟 。 花 费 
这 点 精力 消除 此 类 烦人 的 事情 还 是 非常 值得 的 。 

















8.10 测试 驱动 开发 改动 


现在 可 以 将 支持 多 通道 的 代码 变动 测试 驱动 开发 进 writeData() 函数 了 。 通道 数 表 示 了 同时 
音 轨 (来 自 于 不 同 声 源 的 声音 ) 的 数目 ， 这些 音 轨 的 声音 是 同时 播放 的 。 对 于 单 声 道 输出 ,通道 
数 为 1。 对 于 立体 音 输出 , 通道 数 为 2。 播放 一 个 WAV 文 件 需要 按 顺序 遍历 所 有 的 采样 点 。 一 个 采 
样 由 一 系列 子 采样 构成 , 每 个 通道 一 个 。 具有 4 个 采样 的 音频 片段 的 每 个 采样 是 一 个 字 节 ， 如 下 : 

AA BB CC DD 

假设 第 二 个 通道 的 采样 顺序 如 下 : 

01 02 03 04 

那么 最 终 的 WAV 流 应 该 和 下 面 一 样 : 


AA 01 BB 02 CC 03 DD 04 
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wav/10/WavReaderTest.cpp 

#include "CppUTest/TestHarness.h" 
#include "WavReader.h" 

#include <iostream> 

#include <string> 

#include <sstream> 


using namespace std; 


TEST GROUP (WavReader) { 
}; 


TEST(WavReader WriteSamples, IncorporatesChannelCount) { 
char data[] { "0123456789ABCDEFG" }; 
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, 


uint32 t bytesPerSample ( 2 }; 
uint32 t startingSample ( 0 j; 
uint32 t samplesToWrite ( 2 } 
uint32 t channels (2 }; 
reader.writeSamples( 

&out, data, startingSample, samplesToWrite, bytesPerSample, channels); 
CHECK EQUAL ( "01234567", out.str()); 


, 


} 


为 了 避免 现在 就 去 改动 其 他 测试 ， 可 以 使 用 默认 的 channels 参 数 。 和 往常 一 样 ， 我 们 的 目 
的 是 先 让 测试 通过 ， 然 后 再 整理 代码 。 









































wav/10/WavReader.h 


void writeSamples(std::ostream* out, char* data, 
uint32 t startingSample, 
uint32 t samplesToWrite, 
uint32 t bytesPerSample, 
» uint32 t channels-1); 


现在 我 们 实现 让 新 测试 通过 的 代码 。 




















wav/10/WavReader.cpp 


void WavReader::writeSamples(ostream* out, char* data, 
uint32 t startingSample, 
uint32 t samplesToWrite, 
uint32 t bytesPerSample, 
» uint32 t channels) { 
rLog(channel, "writing %i samples", samplesToWrite); 


for (auto sample - startingSample; 
sample < startingSample + samplesToWrite; 
SampLe++) { 
auto byteOffsetForSample = sample * bytesPerSample * channels; 


for (uint32 t channel(0); channel < channels; channel++) { 
auto byteOffsetForChannel - 
byteOffsetForSample + (channel * bytesPerSample); 
for (uint32 t byte{0}; byte < bytesPerSample; byte++) 
out-»put(data[byteOffsetForChannel + byte]); 


vVYVYVVYVYYY 


) 

还 有 一 些 其 他 事情 需要 修正 。 当 写 出 新 的 长 度 为 10 秒 的 WAV 文 件 时 , 我 们 也 更 新 了 数据 段 的 
长 度 。 但 由 于 没有 改 对 通道 数 ， 现 在 的 长 度 是 错 的 。 虽然 只 是 一 行 代码 , 但 我 们 还 是 乐于 将 其 提 
取 为 一 个 函数 ， 以 便 测试 和 改正 。 遵 从 相同 的 方法 吧 ! 写 一 个 测试 以 刻画 已 有 的 行为 ,修改 测试 
来 定义 新 的 行为 ， 并 修改 产品 代码 。 以 下 是 改 完 后 的 测试 、 提 取得 来 的 函数 和 open() 中 的 客户 
端 代码 ， 它 调用 了 这 个 新 的 函数 。 
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wav/11/WavReaderTest.cpp 
TEST_GROUP (WavReader DataLength) { 
WavReader reader{"",""}; 


}; 


TEST(WavReader DataLength, IsProductOfChannels BytesPerSample and Samples) { 
uint32 t bytesPerSample( 2 }; 
uint32 t samples { 5 }; 
uint32 t channels ( 4 }; 


uint32 t length ( reader.dataLength(bytesPerSample, samples, channels) }; 


CHECK EQUAL(2 * 5 * 4, length); 
} 


wav/11/WavReader.cpp 


SS us 
rLog(channel, "total seconds %u ", totalSeconds); 


dataChunk. length = dataLength( 
samplesToWrite, 
bytesPerSample, 
formatSubchunk. channels); 


YvYVYY 


out.write(reinterpret cast«char*-(&dataChunk), sizeof(DataChunk)); 
A 


uint32 t WavReader::dataLength( 
uint32 t samples, 
uint32 t bytesPerSample, 
uint32 t channels 
) const ( 
return samples * bytesPerSample * channels; 





8.41 新 的 场景 


m: 增强 描述 和 
背景 : open() pr 二 步 是 发 送 消息 至 WavDescriptor 对 象 ， 该 对 象 的 工作 
是 将 格式 化 的 记录 追加 至 描述 符 文件 。 WAV 发布 商 的 用 户 界面 用 这 个 描述 符 文件 中 的 内 
Tub 89 WAV x At 
这 个 描述 符 接收 WAV 文 件 名 、( 剪辑 前 的 ) 总 时 间 、 每 秒 的 采样 数 以 及 通道 的 数目 。 
场景 : 作为 内 容 转 销 商 ， 我 想 要 WAV 文 件 中 的 描述 符 也 包括 新 的 剪辑 文件 长 度 。 修 
改 描 述 符 对 象 使 其 接受 文件 长 度 。 
会 有 其 他 开发 者 改变 WavDescriptor 的 实现 , 使 每 个 记录 包含 剪辑 文件 长 度 ( 但 愿 他 们 在 使 用 
TDD! )。 我 们 的 工作 只 是 改变 WavReader 的 实现 。 
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完成 此 事 需 要 做 两 件 事 。 第 一 ， 计 算 或 取得 文件 大 小 ; 第 二 , 证 明 我 们 将 此 文件 大 小 值 传 给 
了 WavDescriptor。 

加 入 新 的 功能 时 , 最 好 先 将 其 作为 一 个 新 的 方法 ,甚至 一 个 新 的 类 。 这 将 确保 代码 的 测试 覆盖 
率 不 会 因为 代码 库 的 增长 而 降低 。 同 时 ， 也 有 助 于 恪守 单一 责任 原则 ， 并 且 从 小 方法 和 类 中 受益 。 
我 们 需要 一 个 函数 , 可 以 在 给 定 一 个 文件 名 时 ， 就 返回 其 大 小 。 为 了 测试 驱动 开发 这 个 新 功 
我 们 这 样 做 : 























anb 
CC 


wav/12/FileUtilTest.cpp 

// 耗 时 的 测试 ， 因 为 需要 和 文件 系统 交互 

TEST GROUP BASE(FileUtil Size, FileUtilTests) { 
F; 


TEST(FileUtil Size, AnswersFileContentSize) { 
string content("12345"); 
createTempFile(content); 


size t expectedSize ( content.length() + sizeof('N0') ); 
LONGS EQUAL(expectedSize, (unsigned)util.size(TempFileName)); 
} 


wav/12/FileUtil.h 
class FileUtil { 
public: 
std::streamsize size(const std::string& name) { 
std::ifstream stream(name, std::ios::in | std::ios::binary); 
stream.seekg(0, std::ios::end); 
return stream.tellg(); 
J 
} " 


这 个 测试 有 什么 问题 吗 ? 它 不 够 快 【 参 见 4.3 节 )。 

在 TDD 过 程 中 , 你 有 可 能 最 终 只 能 得 到 少数 几 个 运行 慢 的 测试 。 或 许 这 没什么 问题 ,但 要 努 
力 使 这 样 的 测试 减少 ,尽量 降 至 零 。 更 重要 的 是 ,， 标 出 这 些 慢 速 的 测试 ， 并 确保 能 够 找到 一 种 运 
行 快速 、 慢 速 ， 或 者 同时 运行 快速 和 慢 速 测 试 集 的 方法 。 























8.12 寻求 更 快 测试 的 简要 探索 

目前 ， 对 WAV Snippet Publiser 代 码 库 来 说 ， 只 有 一 个 慢 速 测 试 。 我 们 将 努力 保持 这 样 。 但 如 
果 需 要 男 一 个 基于 文件 的 实用 程序 ， 要 确保 不 再 添加 第 二 个 慢 速 测试 。 一旦 放任 不 管 , 慢 速 测试 
数量 会 很 快 多 起 来 。 

一 个 可 行 的 方案 是 将 部 分 只 处 理 音 频 流 的 功能 独立 出 来 ， 并 测试 驱动 开发 它 。 对 于 size() 
函数 ， 我 们 甚至 可 以 创建 更 小 的 方法 。 
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wav/12/StreamUtilTest.cpp 


TEST(StreamUtil Size, AnswersNumberOfBytesWrittenToStream) { 
istringstream readFrom("abcdefg"); 


CHECK EQUAL(7, StreamUtil::size(readFrom)); 
} 


wav/12/StreamUtil.cpp 


std::streamsize size(std::istream& stream) { 
stream.seekg(0, std::ios::end); 
return stream.tellg(); 


) 
FileUtil 类 的 size( ) Pj fc Hi Æ fj PR yap StreamUti DS size PIC, M% T —"ifstream 

引用 。 我 们 可 以 认为 这 个 文件 实用 函数 很 小 ， 以 至 于 不 会 被 破坏 ， 不 需要 为 之 编写 测试 。 
我 们 也 可 以 创建 FileUtil 类 成 员 函 数 execute() ， 这 个 函数 唯一 要 做 的 就 是 创建 一 个 itream 

对 象 ， 然 后 将 它 传递 给 操作 此 对 象 的 函数 。 客 户 端 代码 可 能 会 给 execute( ) 传递 一 个 函数 指针 。 



































wav/12/FileUtilTest.cpp 


streamsize size - util.execute(TempFileName, 
[S] (istream& s) ( return StreamUtil::size(s); )); 


wav/12/FileUtil.h 
std::streamsize execute( 
const std::string& name, 
std::function«std::streamsize (std::istream&)» func) { 
std::ifstream stream[name, std::ios::in | std::ios::binary]; 
return func(stream); 


) 
这 样 做 的 好 处 是 ,我 们 只 需要 为 execute( ) 写 一 个 测试 来 和 文件 打交道 。 其 他 测试 仅仅 基于 
流 ， 执 行 会 很 快 。 








8.13 立竿见影 的 提取 


我 们 需要 找 出 open( ) 函数 中 哪些 地 方 调用 了 size() 。 这 个 调用 可 能 会 在 open () 函数 结尾 ， 
在 给 descriptor 对 象 发 送 消息 之 前 。 但 因为 size() 会 重新 打开 文件 ， 所 以 需要 确保 新 的 WAV 文 
件 首先 被 关闭 。 

不 幸 的 是 ， 理 解 open() 函数 体 的 结构 具有 挑战 性 。 调 用 descriptor 成 员 函 数 之 前 的 代码 充斥 
着 文件 的 读 和 写 。 编 写 一 个 测试 执行 整个 函数 依然 相当 困难 。( 可 以 给 open() 传 人 一 个 真实 、 经 
过 验证 的 WAV 文 件 ， 但 这 样 就 会 得 到 一 个 慢 速 、 对 外 有 依赖 的 测试 。) 

相反 ， 我 们 重 构 open() ， 目 的 是 得 出 一 些 可 以 存根 或 模拟 的 函数 。 经 过 几 十 分 钟 的 函数 提 
取 , 代码 看 上 去 好 多 了 。 虽然 有 些 地 方 的 代码 仍然 有 点 丑 , 但 得 到 的 函数 更 容易 让 人 理解 消化 了 。 
























































184 £83 遗留 代码 的 挑战 





wav/13/WavReader.cpp 


void WavReader::open(const std::string& name, bool trace) { 
rLog(channel, "opening %s", name.c str()); 


ifstream file(name, ios::in | ios::binary); 

if (!file.is open()) { 
rLog(channel, "unable to read *ss", name.c str()); 
return; 


} 


ofstream out{dest_ + "/" + name, ios::out | ios::binary}; 


FormatSubchunk formatSubchunk; 
FormatSubchunkHeader formatSubchunkHeader; 
readAndWriteHeaders(name, file, out, formatSubchunk, formatSubchunkHeader); 


DataChunk dataChunk; 
read(file, dataChunk); 


rLog(channel, "riff header size = %i" , sizeof(RiffHeader)); 
rLog(channel, "subchunk header size = *si", sizeof(FormatSubchunkHeader)); 
rLog(channel, "subchunk size = *si", formatSubchunkHeader.subchunkSize); 
rLog(channel, "data length = %i", dataChunk. length); 


auto data = readData(file, dataChunk.length); // 泄漏 ! 


writeSnippet(name, file, out, formatSubchunk, dataChunk, data); 


} 


void WavReader::read(istream& file, DataChunk& dataChunk) { 
file.read(reinterpret cast«char*»(&dataChunk), sizeof(DataChunk)); 


char* WavReader::readData(istream& file, int32 t length) { 
auto data - new char[length]; 
file.read(data, length); 
//file.close(); // istreams 是 RAII 
return data; 


) 


void WavReader::readAndWriteHeaders( 
const std::string& name, 
istream& file, 
ostream& out, 
FormatSubchunk& formatSubchunk, 
FormatSubchunkHeader& formatSubchunkHeader) { 
RiffHeader header; 
file.read(reinterpret cast«char*»(&header), sizeof(RiffHeader)); 
Zu 


void WavReader::writeSnippet( 
const string& name, istream& file, ostream& out, 
FormatSubchunk& formatSubchunk, 





DataChunk& dataChunk, 
char* data 


) 1 
uint32 t secondsDesired[10); 
if (formatSubchunk.bitsPerSample == 0) formatSubchunk.bitsPerSample = 8; 
uint32 t bytesPerSample(formatSubchunk.bitsPerSample / uint32 t{8}}; 


uint32 t samplesToWrite[secondsDesired * formatSubchunk.samplesPerSecond]; 
uint32 t totalSamples(dataChunk.length / bytesPerSample); 


samplesToWrite = min(samplesToWrite, totalSamples); 
uint32 t totalSeconds[totalSamples / formatSubchunk.samplesPerSecond]); 
rLog(channel, "total seconds %u ", totalSeconds); 


dataChunk.length - dataLength( 
samplesToWrite, 
bytesPerSample, 
formatSubchunk. channels); 
out.write(reinterpret cast«char*-(&dataChunk), sizeof(DataChunk)); 


uint32 t startingSample( 
totalSeconds >= 10 ? 10 * formatSubchunk.samplesPerSecond : 0j; 


writeSamples(&out, data, startingSample, samplesToWrite, bytesPerSample); 
rLog(channel, "completed writing *ss", name.c str()); 


descriptor -»-add(dest , name, 
totalSeconds, formatSubchunk.samplesPerSecond, formatSubchunk.channels); 


//out.close(); // ostreamsXRAI 


因为 现在 writeSnippet() 接 收 一 个 输入 流 和 一 个 输出 流 , 所 以 它 就 不 再 直接 依赖 文件 系统 。 
现在 为 其 写 一 个 测试 或 者 为 read() 和 readData() 写 测试 似乎 合理 了 。 在 写 测试 前 , 还 要 将 read- 
AndwriteHeaders() (没有 完全 列 出 来 ) 重 构 为 更 易于 管理 的 代码 ， 这 样 做 不 会 花费 太 长 时 间 。 

我 们 甚至 还 发 现 了 一 个 可 能 的 内 存 泄漏 问题 。 将 代码 碎 化 成 更 小 的 函数 使 缺陷 变 得 显而易见 。 

在 重 构 过 程 中 , 我 们 删除 to-do 并 注释 掉 关闭 流 的 调用 。 我 们 需要 马上 修正 选择 , 但 也 没 必 要 
显 式 地 关闭 文件 ( std::ofstream 支 持 RAII” )，cLose() 也 不 是 std::ostream 的 接口 。 或 许 我 们 的 分 析 
已 经 够 多 了 ， 现 在 是 时 候 手动 或 自动 地 运行 手头 的 测试 了 。 

我 们 做 好 处 理 文件 大 小 场景 的 准备 了 吗 ? 多 一 点 重 构 或 许 会 使 事情 变 得 更 简单 ， 既 然 
writeSnippet() 已 经 是 小 是 专注 的 函数 ， 让 我 们 研究 一 下 能 怎么 测试 它 。 我 们 将 会 写 一 些 测试 
来 刻画 其 各 类 行为 。 
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pm 






































(D RANEJ Resource Acquisition Is Itialization ， 这 是 一 个 编程 惯用 法 ， 起 源 于 编写 异常 安全 的 C++ 代码 。 参 见 
https:;//en.wikipedia.org/wiki/Resource Acquisition Is_Initialization。 一 一 译 者 注 
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8.14 ”用 成 员 变量 查看 状态 


首先 要 确保 正确 地 计算 出 totalSeconds ， 这 个 值 会 传 给 descriptor。( 如 果 不 准备 改动 
writeSnippet() 消 数 ， 或 许 就 不 需要 为 之 写 测试 。 这 里 写 了 一 个 测试 来 演示 特殊 的 技巧 。) 











wav/14/WaveReaderTest.cpp 


TEST GROUP (WavReader WriteSnippet) { 
WavReader reader("",""3; 
istringstream input{""}; 
FormatSubchunk formatSubchunk; 
ostringstream output; 

DataChunk dataChunk; 
char* data; 
uint32 t TwoBytesWorthOfBits(2 * 8j; 


void setup() override ( 
data = new char[4]; 


} 


void teardown() override { 
delete[] data; 
F 
}; 


TEST(WavReader WriteSnippet, UpdatesTotalSeconds) { 
dataChunk.length = 8; 
formatSubchunk.bitsPerSample = TwoBytesWorthOfBits; 
formatSubchunk.samplesPerSecond = 1; 


reader.writeSnippet("any", input, output, formatSubchunk, dataChunk, data); 


CHECK EQUAL(8 / 2 / 1, reader.totalSeconds); 
} 











在 这 个 测试 中 ， 我 们 做 了 大 量 的 初始 化 工作 。 因 为 这 些 工 作 和 测试 最 终 期 竺 的 结 


所 以 可 以 将 这 些 初始 化 代码 放 在 WavReader WriteSnippet 测 试 组 (fixture ) 定义 中 。 








果 不 相干 ， 
同时 ， 也 可 





把 WavReader.cpp 中 的 struct 定 义 移 至 WavReader.h 中 ， 这 样 测试 就 能 访问 这 些 结构 了 。 











等 等 ! 如 ) 
































简单 : totalSeconds 现 在 是 公共 的 成 员 变 


wav/14/WavReader.h 


public: 
JA MET 
uint32 t totalSeconds; 


wav/14/WavReader.cpp 


void WavReader::writeSnippet( 
const string& name, istream& file, ostream& out, 


250 i quM 那 怎么 去 验证 它 的 值 呢 ? 答案 很 
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FormatSubchunk& formatSubchunk, 

DataChunk& dataChunk, 

char* data 

) 1 
uint32 t secondsDesired[10); 
if (formatSubchunk.bitsPerSample == 0) formatSubchunk.bitsPerSample = 8; 
uint32 t bytesPerSample(formatSubchunk.bitsPerSample / uint32 t{8}}; 


uint32 t samplesToWrite[secondsDesired * formatSubchunk.samplesPerSecond]; 
uint32 t totalSamples([dataChunk.length / bytesPerSample]); 


samplesToWrite = min(samplesToWrite, totalSamples); 
» totalSeconds - totalSamples / formatSubchunk.samplesPerSecond; 


rLog(channel, "total seconds %u ", totalSeconds); 
// nia 
} 


测试 偷偷 地 查看 本 应 对 外 不 可 见 的 totalSeconds。 万 恶 之 源 啊 ! 有 时 为 了 能 够 把 控 遗 留 代 
码 , 我 们 需要 做 些 和 弄 脏 代码 的 事情 , 要 提醒 自己 进一步 改动 代码 , 若 不 知道 是 否 会 破坏 一 些 功能 
Vu 3o (C03 35:49: 38 JE 


除 此 之 外 ， 还 有 一 个 应 对 这 种 情况 的 更 好 方法 。 






































8.15 用 mock 查看 状态 


writeSnippet () 函 数 的 目的 之 一 是 将 总 秒 数 传 给 descriptor。 在 前 一 节 中 , 我 们 将 其 改 为 成 
员 变 量 以 便 查 看 此 值 。 我 们 也 可 以 让 WavReader 用 descriptor 的 测试 蔡 身 来 得 到 发 送 给 descriptor 
的 值 。 


你 已 经 在 第 $ 章 中 学 习 了 怎样 用 Google Mock 创 建 测试 奉 身 。 由 于 本 章 示 例 中 使 用 的 是 
CppUTest， 我 们 将 使 用 其 自 带 的 mock 工 具 一 一 CppUMock。 和 Google Mock 一 样 ， 我 们 定义 了 
WavDescriptor 的 派生 类 ， 它 将 查看 发 送 到 其 add ( ) 函数 的 消息 。 











wav/15/WavReaderTest.cpp 


class MockWavDescriptor : public WavDescriptor { 
public: 
MockWavDescriptor(): WavDescriptor("") {} 
void add( 
const string&, const string&, 
uint32 t totalSeconds, 
uint32 t, uint32 t) override { 
» mock().actualCall("add") 
» .WithParameter("totalSeconds", (int)totalSeconds); 
j 
}; 


为 了 履 写 add () ， 我 们 需要 将 其 在 WavDescriptor 中 的 声明 改 为 虚拟 函数 。 


188 — £83 HER XU DG 





wav/15/WavDescriptor.h 


» virtual void add( 

const std::string& dir, const std::string& filename, 
uint32 t totalSeconds, uint32 t samplesPerSecond, 
uint32 t channels) ( 

LS A 

WavDescriptorRecord rec; 

cpy(rec.filename, filename.c_str()); 

rec.seconds = totalSeconds; 

rec.samplesPerSecond = samplesPerSecond; 
rec.channels = channels; 


Yyyy 


outstr->write(reinterpret cast<char*>(&rec), sizeof(WavDescriptorRecord)); 


} 


MockWavDescriptor 中 标记 出 来 的 代码 行 命令 CppUTest 全 局 对 象 MockSupport ( 通过 调用 








mock () 获得 ) 记 录 对 名 为 add 的 函数 的 调用 。MockSupport 对 象 会 同时 得 到 参数 名 为 totalSeconds 
的 值 。( 我 用 括号 将 这 些 名 称 括 起 来 是 因为 在 使 用 CppUMock 时 可 以 任意 命名 。 这 是 一 个 相对 方 


























便 的 反射 。) 
通过 WavReader 的 构造 函数 ， 我 们 将 测试 蔡 身 注入 WavReader 对 象 中 。 
wav/15/WavReader.cpp 
TEST GROUP (WavReader WriteSnippet) { 
» shared ptr«MockWavDescriptor» descriptor(new MockWavDescriptor]; 
» WavReader reader("", "", descriptor); 


istringstream input(""); 
FormatSubchunk formatSubchunk; 
ostringstream output; 
DataChunk dataChunk; 
char* data; 
uint32 t TwoBytesWorthOfBits(2 * 8j; 
void setup() override ( 

data = new char[4]; 


H 


void teardown() override { 
mock().clear(); 
delete[] data; 
J 
}; 


在 测试 中 , 我 们 会 通知 MockSupport 对 象 期 望 一 个 名 为 add 的 函数 被 调用 。 同 时 通知 它 ， 








调用 


的 totalSeconds 的 参数 为 一 个 特定 的 值 。 测试 的 这 种 安排 就 是 设立 期 望 ,一 日 writeSnippet() 


被 调用 ， 测 试 的 断言 部 分 就 会 验证 加 入 到 MockSupport 对 象 中 的 所 有 期 望 是 否 满足 。 





wav/15/WavReaderTest.cpp 


TEST(WavReader WriteSnippet, UpdatesTotalSeconds) { 
dataChunk.length = 8; 
formatSubchunk.bitsPerSample - TwoBytesWorthOfBits; 
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formatSubchunk.samplesPerSecond = 1; 
> mock().expectOneCall("add").withParameter("totalSeconds", 8 / 2 / 1); 
reader.writeSnippet("any", input, output, formatSubchunk, dataChunk, data); 
» mock().checkExpectations(); 
} 


相应 地 , 我 们 将 descriptor 指 针 改 为 共享 指针 。 使 用 共享 指针 允许 测试 和 产品 代码 正确 地 管理 
descriptor 对 象 的 创建 与 删除 。 同 时 ,为 了 最 小 化 对 现 有 测试 的 影响 ,我 们 将 descriptor 的 构造 参数 
默认 为 空 指 针 。 





wav/15/WavReader.h 


class WavReader { 
public: 
WavReader( 
const std::string& source, 
const std::string& dest, 
std::shared ptr«WavDescriptor» descriptor-0); 
FI siia 
private: 
JI iaa 
std::shared ptr«WavDescriptor» descriptor ; 


wav/15/WavReader.cpp 


WavReader: :WavReader( 
const std::string& source, 
const std::string& dest, 
» shared ptr«WavDescriptor» descriptor) 
: source (source) 
, dest (dest) 
» , descriptor (descriptor) { 
» if (!descriptor ) 
» descriptor = make shared«WavDescriptor»(dest); 


channel = DEF CHANNEL ("info/wav", Log Debug); 
log.subscribeTo((RLogNode*)RLOG CHANNEL ( "info/wav")); 


rLog(channel, "reading from %s writing to *ss", source.c str(), dest.c str()); 


} 


WavReader::-WavReader() 1 
» descriptor .reset(); 
delete channel; 








需要 改变 正在 测试 的 writeSnippet() 函数 中 的 任何 代码 ! writeSsnippet() 依 旧 对 
用 add() ， 而 不 需要 知道 descriptor 是 产品 代码 WavDescriptor 的 类 实例 还 是 测试 蔡 身 。 


通过 测试 驱动 开发 writeSsnippet () 来 获取 和 传递 文件 大 小 ,我们 终于 可 以 完成 场景 中 所 描 
述 的 需求 了 。 实 际 上 ， 我 们 选择 测试 UpdatesTotalSecond， 并 更 新 它 来 验证 这 两 个 参数 。 为 了 支 
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持 给 定 获取 文件 大 小 请 求 的 存根 回馈， 我 们 创建 了 FileUtil 的 mock。FileUtil 的 mock 有 是 


数 而 非 构造 函数 注入 的 。 


YYVYVYY 


wav/16/WavReaderTest.cpp 


class MockWavDescriptor : public WavDescriptor { 
public: 


}; 


MockWavDescriptor(): WavDescriptor("") {} 
void add( 
const string&, const string&, 
uint32 t totalSeconds, 
uint32 t, uint32 t, 
uint32 t fileSize) override { 
mock().actualCall("add") 
.withParameter("totalSeconds", (int)totalSeconds) 
.WithParameter("fileSize", (int)fileSize); 


class MockFileUtil: public FileUtil { 
public: 


}; 


streamsize size(const string& name) override { 
return mock().actualCall("size").returnValue().getIntValue(); 


TEST GROUP (WavReader WriteSnippet) { 


TEST(WavReader WriteSnippet, SendsFileLengthAndTotalSecondsToDescriptor) 


shared ptr«MockWavDescriptor» descriptor(new MockWavDescriptor]; 
WavReader reader("", "", descriptor); 


shared ptr«MockFileUtil» fileUtilimake shared«MockFileUtil-()]; 


istringstream input(""); 
FormatSubchunk formatSubchunk; 
ostringstream output; 

DataChunk dataChunk; 

char* data; 

uint32 t TwoBytesWorthOfBits(2 * 8j; 


const int ArbitraryFileSize(5); 


void setup() override ( 
data = new char[4]; 
reader.useFileUtil(fileUtil); 
} 


void teardown() override { 
mock().clear(); 
delete[] data; 
































通 


过 setter 函 
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dataChunk.length = 8; 
formatSubchunk.bitsPerSample = TwoBytesWorthOfBits; 
formatSubchunk.samplesPerSecond - 1; 


» mock().expectOneCall("size").andReturnValue(ArbitraryFileSize); 


mock().expectOneCall("add") 
.WithParameter("totalSeconds", 8 / 2 / 1) 


» .withParameter("fileSize", ArbitraryFileSize); 
reader.writeSnippet("any", input, output, formatSubchunk, dataChunk, data); 


mock().checkExpectations(); 


wav/16/WavReader.cpp 
void WavReader::writeSnippet( 
const string& name, istream& file, ostream& out, 
FormatSubchunk& formatSubchunk, 
DataChunk& dataChunk, 
char* data 
)t 
IT njia 
writeSamples(&out, data, startingSample, samplesToWrite, bytesPerSample); 


rLog(channel, "completed writing *ss", name.c str()); 
» auto fileSize = fileUtil -»size(name); 
descriptor -»-add(dest , name, 
totalSeconds, formatSubchunk.samplesPerSecond, formatSubchunk.channels, 


» fileSize); 


//out.close(); // ostreams 是 RAII 





8.16 ”其 他 注入 技巧 


到 目前 为 止 ,我 们 介绍 了 很 多 创新 性 的 技巧 ,这 些 技 巧 可 以 提升 应 对 难以 测试 的 代码 的 能 
我 们 使 用 构造 函数 注入 、setter 函 数 注入 和 成 员 变 量 探测 。 你 在 第 5 童 中 学 到 的 技巧 ， 如 覆 写 工厂 
方法 或 通过 模板 参数 ,都 可 以 在 这 里 派 上 用 场 。 如 果真 的 需要 , 你 甚至 可 以 尝试 更 富 创 新 性 的 技 
巧 ， 例 如 ， 使 用 预 处 理 咒 重新 定义 代码 。 


避免 只 使 用 一 种 打破 依赖 的 技巧 而 陷入 钉 锤 陷阱 。《 修 改 代码 的 艺术 》 介 绍 了 许多 有 用 的 模 
式 。 你 要 做 的 就 是 熟悉 这 些 模式 ， 以 便 选择 最 适合 当前 处 境 的 方法 。 
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8.17 用 Mikado 方法 大 规模 改动 代码 


有 时 你 需要 大 规模 地 改动 代码 。 代 码 或 许 会 传递 分 散 的 变量 , 这 时 你 会 想 将 它们 聚合 起 来 放 
进 一 个 结构 体 中 ,又 或 者 你 想 要 重新 组 织 被 许多 客户 使 用 的 大 型 类 。 可 能 需要 几 天 或 儿 个 星期 来 
完成 这 些 改动 。 这 几 天 或 几 周 的 日 子 会 很 难熬 ， 因 为 你 必须 努力 改动 代码 。 

在 开始 为 改动 做 扫尾 工作 时 , 通常 你 会 发 现 更 多 需要 改动 的 代码 。 你 或 许 会 发 现 , 这 些 要 改 
动 的 代码 自身 会 牵扯 出 与 当前 改动 无 关 的 、 但 又 必须 先 完 成 的 改动 。 于 是 ， 几 天 就 会 变 成 几 周 或 
更 长 时 间 。 

你 甚至 可 能 没有 时 间 来 做 这 些 工 作 。 公 司 业务 发 展 可 能 会 提高 另 一 个 任务 的 优先 级 , 人 迫使 你 
放弃 提升 当前 代码 的 工作 。 假 如 你 的 工作 在 主线 (trunk ) E, 那么 就 有 可 能 因为 放弃 未 完成 的 解 
决 方案 而 使 代码 处 于 更 差 的 状态 。 更 糟糕 的 是 ， 即 便 到 目前 为 止 一 直 很 努力 ,你 或 许 还 是 没 能 弄 
清楚 当前 的 进展 和 那些 未 完成 的 工作 。 同 时 ， 只 完成 一 半 的 解决 方案 会 妨碍 其 他 人 的 改动 工作 ， 
这 会 使 团队 的 其 他 成 员 感 到 疑惑 和 泪 丧 。 即 使 最 终 重 拾 最 初 的 重 构 工作 , 也 可 能 要 花 大 量 时间 回 
想 当 时 的 进度 ,以 及 还 有 哪些 工作 没有 做 。 

如 果 起 初 是 在 分 支 上 做 出 大 量 的 改动 , 那么 你 会 发 现 , 要 合并 的 代码 变 多 了 ， 且 需要 更 长 的 
时 间 来 完成 合并 。 如 果 其 他 开发 者 修改 的 代码 和 你 修改 的 代码 有 交集 ( 显然 ,他们 没有 为 你 的 代 
码 健康 考虑 )， 那 么 即使 增 量 地 合并 也 会 令 你 诅 丧 透顶 。“ 可 以 等 我 完成 四? ”不 。 

由 Daniel Brolund 和 Ola Ellnestam 发 明 的 Mikado 方 法 提供 了 一 个 有 章 可 循 的 方法 。 你 可 以 在 
The Mikado Method [EB14] 中 深入 阅读 关于 此 技巧 的 知识 。 本 章 余 下 的 部 分 将 简要 概览 此 过 程 ， 
并 带 你 一 同体 验 此 技巧 的 使 用 。 





































































































8.18 Mikado 方法 概览 


完整 的 过 程 要 经 历 看 上 去 令 人 却步 的 9 个 步骤 。 然 而 ,一 旦 经 历 过 几 次 后 ， 你 会 感到 这 再 自 
然 不 过 了 。 习 惯 该 方法 甚至 比 习 惯 TDD 步 又 还 要 快 。 


(1) 制定 Mikado 目 标 以 及 想 要 达到 的 最 终 状 态 。 

(2) 以 最 稚 拙 的 方法 实现 这 一 目标 。 

(3) 找 出 所 有 的 错误 。 

(4) 找到 解决 错误 的 即时 方案 。 

(5) 将 即时 方案 作为 新 的 前 提 目 标 。 

(6) 如 果 有 错误 ， 将 相应 的 代码 回 滚 到 最 初 状态 。 

(7) 对 每 个 方案 重复 步骤 2 至 步 又 6。 

(8) 检查 代码 是 否 存在 错误 ; 将 前 提 目 标 标记 为 完成 。 
(9) 完成 了 Mikado 目 标 吗 ?如 果 是 ,任务 完成 ! 
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做 大 规模 重 构 工 作 的 大 部 分 时 间 最 终 并 不 是 花 在 实际 的 代码 改动 本 身 。 通 常 来 说 ,每 个 改动 
都 很 小 (虽然 改动 很 多 )。 相反, 大 部 分 时 间 花 在 必要 条 件 分 析 和 自我 思索 上 。 “调用 这 个 函数 的 
所 有 客户 代码 在 哪 ? 如 果 改 动 它们 , 还 有 哪些 客户 代码 会 受到 影响 ?代码 到 底 做 了 什么 ?我 要 怎 
样 证 明代 码 依然 工作 ? ” 

你 可 以 用 Mikado 方 法 将 分 析 和 基于 分 析 改 动 代码 的 时 间 相 分 离 。 可 以 将 代码 改动 约 简 为 简单 
的 改动 图 ， 或 Mikado 图 ， 即 一 些 脚 本 。 这 个 图 用 于 描绘 主 目标 ， 即 Mikado 目 标 ， 以 及 主 目标 所 
依赖 的 一 系列 其 他 目标 。 通常 而 言 , 将 图 中 改动 的 元 素 依 次 应 用 到 代码 库 中 。 这 个 动作 能 让 你 以 
高 度 的 自信 快速 、 正 确 地 改动 代码 。 
通过 建立 Mikado 图 , 你 可 以 对 必须 要 完成 的 任务 形成 可 视 化 的 总 结 , 还 可 以 将 这 些 任务 分 发 
给 团队 成 员 以 加 速达 成 Mikado 目 标 。Mikado 图 为 团队 间 的 沟通 和 协作 提供 了 一 个 中 心 点 。 




















8.19 FH Mikado 移动 一 个 方法 


我 们 可 以 将 WAV 片 段 或 WAV 片 段 写 出 器 (snippet writer ) 作为 独立 的 抽象 。 主 类 WavReader 
的 名 字 已 经 表明 ， 此 类 中 的 任何 写 出 片段 都 不 是 其 职责 。 此 外 ， 我 们 正在 大 量 地 修改 片段 逻辑 ， 
并 想 将 这 些 改动 局 限于 更 小 的 类 范围 。 


作为 短期 的 Mikado 目 标 ， 我 们 要 将 writeSsnippet() 提 取 为 一 个 类 ， 即 Snippet。 一 旦 完成 这 
个 即时 目标 ， 我 们 便 计划 相应 地 整理 Snippet 代 码 。 但 是 ， 每 次 只 集中 一 个 目标 。 


考虑 到 篇 幅 限 制 , 这 个 示例 相对 较 小 , 但 其 真实 性 与 日 常 做 的 重 构 一 样 。 即 使 这 是 个 很 小 的 
任务 , 你 还 是 会 惊讶 于 即将 经 历 的 许多 步骤 。Mikado 方 法 让 你 不 会 在 穿梭 于 这 些 步 又 时 技 下 或 完 
全 漏 掉 目标 。 

作为 Mikado 方 法 的 第 一 步 , 我 们 用 同心 的 双 椭 圆 表 示 最 终 目 标 。 我 们 倾向 于 将 一 个 大 的 白板 
作为 工具 。 因为 我 们 希望 每 个 人 都 能 看 到 Mikado 图 , 所 以 需要 大 量 的 空间 , 在 修改 代码 的 过 程 中 ， 
我 们 会 增 量 地 构建 这 个 图 。 




















































从 WavReader 中 提取 
Snippet 代 码 


根据 Mikado 方 法 的 第 二 步 , 我 们 以 最 稚 拙 的 方法 直 奔 目标 。 将 writeSnippet () 函数 移 至 ( 58 
切 并 粘贴 ) 一 个 新 文件 Snippeth 中 ， 并 将 其 放 和 人 一 个 类 定义 中 。 








wav/17/Snippet.h 


#ifndef Snippet h 
define Snippet h 
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class Snippet { 
public: 


void writeSnippet( 
const string& name, istream& file, ostream& out, 
FormatSubchunk& formatSubchunk, 
DataChunk& dataChunk, 
char* data 
)t 
Jf vs 
uint32 t secondsDesired(10); 
if (formatSubchunk.bitsPerSample == 0) formatSubchunk.bitsPerSample = 8; 
uint32 t bytesPerSample(formatSubchunk.bitsPerSample / uint32 t(8]); 


uint32 t samplesToWrite([secondsDesired * formatSubchunk.samplesPerSecond); 
uint32 t totalSamples([dataChunk.length / bytesPerSample]; 


samplesToWrite = min(samplesToWrite, totalSamples); 
uint32 t totalSeconds ( totalSamples / formatSubchunk.samplesPerSecond }; 
rLog(channel, "total seconds %i ", totalSeconds); 
dataChunk.length = dataLength( 
samplesToWrite, 
bytesPerSample, 
formatSubchunk. channels); 


out.write(reinterpret cast«char*»(&dataChunk), sizeof(DataChunk)); 


uint32 t startingSample( 
totalSeconds >= 10 ? 10 * formatSubchunk.samplesPerSecond : 0}; 


writeSamples(&out, data, startingSample, samplesToWrite, bytesPerSample); 
rLog(channel, "completed writing *ss", name.c str()); 


auto fileSize = fileUtil -»size(name); 
descriptor -»-add(dest , name, 


totalSeconds, formatSubchunk.samplesPerSecond, formatSubchunk.channels, 


fileSize); 
//out.close(); // ostreams RAII 
} 
H 
#endif 


我 们 在 WavReader 中 创建 一 个 Snippet 对 象 ， 然 后 调用 其 writeSnippet() 成 员 











wav/17/WavReader.cpp 


#include "Snippet.h" 


J£ ow 
void WavReader::open(const std::string& name, bool trace) { 


74 A 
auto data = readData(file, dataChunk.length); // ik! 


函数 。 
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» Snippet snippet; 
» snippet.writeSnippet(name, file, out, formatSubchunk, dataChunk, data); 
} 


进行 编译 ( Mikado 方 法 的 第 三 步 : 找 出 所 有 的 错误 )。 快 速 检查 编译 错误 发 现 ,因为 在 Snippet.h 
中 漏 掉 了 一 些 定 义 ， 所 以 调用 writeSnippet() 的 代码 无 法 编译 。 

为 了 完成 Mikado 目 标 ， 我 们 需要 完成 两 个 前 提 任 务 (Mikado 方 法 的 第 四 步 : 找到 解决 错误 
的 即时 方案 ): 

(1) 粘贴 代码 以 便 得 到 一 个 新 Snippet 类 ; 

(2) 修改 WavReader 以 便 使 用 Snippet 对 象 ( 我 们 已 经 尝试 了 修改 代码 )。 

将 此 改进 作为 前 提 更 新 进 Mikado 图 ( Mikado 方 法 的 第 五 步 : 将 即时 方案 作为 新 的 前 提 目 标 )。 



















































将 Snippet 代 码 提 取 
到 一 个 新 的 类 中 


从 WavReader 中 调用 
Snippet 代 码 


稍 后 ， 我 们 会 回头 处 理 从 WavReader 中 调用 Snippet 的 代码 。 现 在 先 集中 创建 Snippet 类 ， 它 是 
一 个 可 以 持续 丰富 的 独立 类 。 

最 有 趣 的 部 分 是 Mikado 方 法 的 第 六 步 。 因 为 有 错误 ,所 以 我 们 回 深 代 码 改 动 。 是 的 ,丢弃 修 
改 的 代码 。 我 们 已 经 得 到 了 分 析 结 果 , 并 标记 在 了 Mikado 图 中 , 一 旦 知道 要 做 什么 , 真正 改动 代 
码 不 会 花费 太 长 时 间 (我 们 会 在 后 文中 讨论 到 )。 

如 果 你 在 使 用 像 git 一 样 好 的 源 代码 管理 工具 ， 那 么 Mikado 方 法 的 第 六 步 会 非常 简单 : 

git reset -hard && git clean -f 

这 当然 可 能 会 导致 数据 丢失 。< Insert standard legal disclaimer here. 


继续 ! 我 们 的 目标 是 , 不 断 地 走向 Mikado 图 的 叶 节 点 一 一 不 需要 任何 前 提 动 作 就 可 以 完成 的 
任务 , 不 断 为 每 个 节点 重复 前 面 所 述 的 Mikado 步 又 。 现在 要 做 的 是 ,判断 通过 复制 代码 而 创建 新 
的 Snippet 类 是 否 为 叶 节 点 。 第 一 次 尝试 基本 和 之 前 写 的 代码 一 样 : 将 writeSnippet() 复 制 到 
Snippeth， 把 它 放 进 类 定义 中 ， 从 声明 中 移 除 WavReader: : 。 为 了 让 编译 器 找到 Snippetnh ， 在 
WavReader 中 加 入 #include。 


对 一 些 人 来 说 , 选择 可 能 会 失败 的 简单 目标 有 点 令 人 厌烦 。 但 这 使 我 们 不 必 在 没有 任何 具体 
反馈 前 就 没完 没 了 地 做 分 析 。 而 且 ， 这 也 有 助 于 在 Mikado 图 中 勾勒 更 小 的 子 步 又 。 


我 们 再 次 收 到 了 关于 未 识别 std 类 型 的 编译 错误 , 但 这 次 的 编译 器 输出 没有 和 WavReader 中 的 
问题 混在 一 起 。 为 了 加 速达 成 Mikado 目 标 , 我 们 决定 加 入 using 指 示 符 来 解决 问题 。 是 的 , 这 “不 






通过 复制 代码 构建 
新 Snippet 类 
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好 ”。 我 们 先 做 个 记录 ， 等 完成 Mikado 目 标 后 再 整理 代码 。( 也 可 以 将 整理 代码 作为 Mikado 图 的 
一 个 节点 ， 但 我 们 目前 先 保持 示例 简单 化 。) 


解决 错误 的 方案 生成 了 新 的 Mikado 目 标 。 





将 Snippet 代 码 提取 
到 一 个 新 的 类 中 


从 WavReader 中 调 通过 复制 代码 构建 
用 Snippet 代 码 新 的 Snippet 类 


Mikado 图 有 点 简略 ,也 许 不 能 满足 你 的 要 求 , 但 可 以 满足 我 们 的 需求 。 我 们 的 目标 包括 命名 
空间 声明 、Snippet.h 和 类 定义 。 

你 或 许 在 思索 Mikado 方 法 中 每 一 步 的 粒度 。 是 否 应 该 详细 地 记录 代码 操作 呢 ? 答案 取决 于 问 
题 的 难 易 程度 、 你 是 否 希 望 获得 别人 的 帮助 ， 以 及 加 入 到 任务 中 的 人 理解 到 的 隐 售 之 意 有 哪些 。 
对 大 多 数 任务 而 言 , 你 可 以 总 结 详 细 的 步骤 , 假设 会 记 住 所 需 的 细节 , 或 者 你 的 搭档 知道 要 做 什 
么 。 如 果 想 要 其 他 人 通过 阅读 Mikado 图 就 可 以 改动 代码 ， 你 或 许 还 需要 包含 更 多 的 信息 。 

我 们 的 Mikado 图 展示 了 一 个 相对 低层 次 的 目标 。 对 于 更 大 的 Mikado 目 标 而 言 ， 我 们 要 将 整 
个 目标 (将 Snippet 代 码 提 取 成 新 的 类 ) 作为 单独 的 节点 。 

为 包含 using 指 示 符 来 修复 编译 错误 失败 了 ， 所 以 我 们 再 一 次 回 深 代 码 。 或 许 你 仍然 对 回 
滚 代 码 的 理念 有 点 反感 ， 但 记 住 ， 这 有 助 于 构建 增 量 的 、 文 档 化 很 好 的 解决 方案 路 径 。 

回 滚 代码 会 变 得 非常 自然 。 重 新 改动 代码 花费 的 时 间 会 大 幅 减少 。 你 会 偶尔 尝试 简单 的 方案 ， 
但 基本 行 不 通 。 回 滚 和 重 来 带 来 的 心理 舒适 感 使 你 觉得 压力 全 无 。 

现在 从 “using namespace std;” 日 标 开 始 ， 并 尝试 解决 它 。 在 WavReader 中 加 入 #include 语 
句 。 然 后 创建 Snippeth， 向 其 中 加 入 一 个 类 ， 并 加 入 using 指 示 符 。 
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wav/18/Snippet.h 


#ifndef Snippet h 
define Snippet h 


using namespace std; 
class Snippet { 


public: 
}; 
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#endif 


可 以 了 ! 测试 全 部 通过 了 。 我 们 已 经 完成 了 “using namespace std;” 的 目标 ， 可 以 在 不 破坏 
任何 功能 的 前 提 下 加 入 到 代码 库 了 。 这 时 我 们 可 以 决定 是 否 要 提交 代码 。 因 为 使 用 了 强大 的 源 代 
码 版 本 工具 ， 所 以 我 们 可 以 经 常 提 交代 码 ， 这 是 安全 的 ， 也 不 要 介意 代码 改动 有 多 小 。( 如 果 有 
很 多 代码 提交 ， 使 用 git 可 以 将 它们 合并 为 一 个 。) 


















































将 Snippet 代 码 提取 到 一 
个 新 的 类 中 






通过 复制 代码 构建 新 的 


从 WavReader 中 调用 
Snippet 代 码 Snippet 类 
#include Snippet.h using namespace std; 


我 们 将 这 个 目标 从 Mikado 图 中 色 掉 。 同时 , 将 加 入 WavReader 中 的 #include 语 句 标记 为 已 完 
成 的 目标 。 

我 们 做 了 男 外 一 个 尝试 来 实现 “通过 复制 代码 构建 新 的 Snippet 类 ”的 目标 。 现 在 的 错误 更 少 
了 ， 这 说 明 有 几 个 成 员 ( 既 有 了 郴 数 ， 也 有 变量 ) 未 被 定义 。 现 在 来 看 函数 dataLength() 和 
writeSamptes() ， 我 们 发 现 ， 它 们 不 依赖 任何 成 员 变 量 。 将 复制 这 两 个 函数 作为 下 一 个 前 提 目 
标 最 合适 不 过 了 。 
























将 Snippet 代 码 提 取 到 
一 个 新 的 类 







通过 复制 代码 构建 新 
的 Snippet 类 


将 dataLength 和 


从 WavReader 中 调用 
Snippet 代 码 
writeSample 复 制 过 来 
#include Snippet.h 
using namespace std; 


次 回 深 代 码 并 复制 函数 …… 哦 …… 失 败 了 ! 原来 有 一 个 成 员 变量 channels。( 不 仅 该 变 
量 没 有 帮助 识别 成 员 变 量 的 下 划 线 尾 级 ,而 且 内 内 的 循环 重用 了 这 个 变量 。 呢 , 将 这 个 加 入 稍 后 
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修复 的 列表 中 。 ) 
先 回 滚 代码 ， 并 将 当前 目标 缩减 至 只 复制 dataLength( ) 。 








wav/19/Snippet.h 


class Snippet { 
public: 
uint32_t dataLength( 
uint32_t samples, 
uint32_t bytesPerSample, 
uint32_t channels 
) const { 
return samples * bytesPerSample * channels; 


YVYYVVYVYVYYY 


} 
}; 


提交 代码 并 更 新 Mikado 图 。 







将 Snippet 代 码 提取 
到 一 个 新 的 类 中 


从 WavReader 中 调用 
Snippet 代 码 
来 
3 
stinclude Snippet.h 
using namespace std; ^ 


接 下 来 尝试 复制 writeSsnippets() 和 writeSamptes()。 我 们 再 一 次 失败 了 。 错 误 信息 显示 
未 定义 成 员 变 量 。 解 决 方案 是 向 Snippeth 加 入 构造 函数 变 ARAR 数 变量 。 可 以 做 出 修改 并 提 
交 吗 ? 当然 可 以 ! 最 终 可 以 将 前 提 条 件 色 选 为 已 完成 。 












将 dataLength 复 制 过 























wav/20/Sinppet.h 


class Snippet { 
public: 

Snippet(shared ptr«FileUtil» fileUtil, 
shared ptr«WavDescriptor» descriptor, 
const std::string& dest, 

Flog: :RLogChannel* channel) 
: fileUtil (fileUtil) 
, descriptor (descriptor) 
, dest (dest) 
, channel (channel) ( } 
IA vns 
» private: 
» shared ptr«FileUtil» fileUtil ; 


vVYVYVVYVYYY 
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» shared ptr«WavDescriptor» descriptor ; 
» const string dest ; 
» rlog::RLogChannel* channel ; 

}; 








将 Snippet 代 码 提 取 
到 一 个 新 类 中 













通过 复制 代码 构建 
新 的 Snippet 类 






从 WavReader 中 调用 


Snippet 代 码 将 dataLength 复 制 过 来 





向 Snippet 中 加 入 构造 函数 


变量 和 成 员 函 数 变 量 
e 


耶 ! 回 滚 之 后 ， 我 们 能 够 成 功 复制 writeSnippets() 和 writeSamptLes () ， 然 后 提交 代码 。 
同时 ， 我 们 可 以 将 最 后 一 个 前 提 目 标 标记 为 完成 :“ 从 WavReader 中 调用 Snippet 代 码 ”。 
( snippet .writeSnippt 有 点 琼 手 ,但 我 们 可 以 在 完成 Mikado 目 标 后 重新 命名 这 个 函数 。) 


从 WavReader 中 调用 ^V 
Snippet 代 码 
I 过 来 


将 dataLength 复 制 过 


using namespace std; A 


我 们 的 代码 还 需要 一 些小 的 、 安 全 的 手工 调整 。 将 成 员 变量 channet 重 命名 为 channeL_。 同 
时 为 writeSamptLes() 的 channetLs 参 数 提供 默认 值 1， 从 WavReaderph 中 复制 其 定义 。 即 便 是 很 小 
的 改动 ， 其 中 依然 草 含 着 一 些 可 以 接受 的 风险 〈 这 迫使 我 们 运行 一 些 慢 速 测 试 )。 









#include Snippet.h 




















将 Snippet 代 码 提取 
到 一 个 新 类 中 









从 WavReader 中 调用 ~ 
Snippet 代 码 







向 Snippet 中 加 入 构造 国 
数 变 量 和 成 员 函 数 变量 








#include Snippet.h 








wav/21/Snippet.h 
class Snippet { 
public: 

//h. 


void writeSnippet( 
const string& name, istream& file, ostream& out, 


FormatSubchunk& formatSubchunk, 
DataChunk& dataChunk, 
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char* data 

) 1 
uint32 t secondsDesired(10); 
if (formatSubchunk.bitsPerSample == 0) formatSubchunk.bitsPerSample 
uint32 t bytesPerSample(formatSubchunk.bitsPerSample / uint32 t{8}}; 


28; 


uint32 t samplesToWrite(secondsDesired * formatSubchunk.samplesPerSecond]); 


uint32 t totalSamples(dataChunk.length / bytesPerSample]; 


samplesToWrite - min(samplesToWrite, totalSamples); 


uint32 t totalSeconds { totalSamples / formatSubchunk.samplesPerSecond }; 


» rLog(channel , "total seconds %i ", totalSeconds); 


dataChunk.length = dataLength( 
samplesToWrite, 
bytesPerSample, 
formatSubchunk. channels); 
out.write(reinterpret cast«char*-(&dataChunk), sizeof(DataChunk)); 


uint32 t startingSample( 
totalSeconds »- 10 ? 10 * formatSubchunk.samplesPerSecond : 0j; 


writeSamples(&out, data, startingSample, samplesToWrite, bytesPerSample); 


» rLog(channel , "completed writing *ss", name.c str()); 
auto fileSize = fileUtil -»size(name); 


descriptor --add(dest , name, 
totalSeconds, formatSubchunk.samplesPerSecond, formatSubchunk. 
fileSize); 


//out.close(); // ostreams € RAII 
} 
void writeSamples(ostream* out, char* data, 
uint32 t startingSample, 
uint32 t samplesToWrite, 
uint32 t bytesPerSample, 


» uint32 t channels-1) { 
» rLog(channel , "writing %i samples", samplesToWrite); 
// ... 
} 
}; 
/wav21/WavReader.cpp 


void WavReader::open(const std::string& name, bool trace) { 
7A PEE 
auto data = readData(file, dataChunk.length); // 泄漏 ! 


writeSnippet(name, file, out, formatSubchunk, dataChunk, data); 


channels, 
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任务 完成 了 吗 ? 不 完全 吧 ! 我 们 需要 删除 WavReader 中 的 三 个 函数 ， 这 个 步骤 还 没 反映 在 
Mikado 图 中 。 我 们 可 以 将 它 作为 主 目标 (C “将 Snippet 代 码 提 取 到 一 个 新 类 中 ”) 的 前 提 目 标 。 


从 WavReader 中 移 除 函数 


通过 复制 代码 构建 新 的 
Snippet 类 








将 Snippet 代 码 提取 到 
一 个 新 的 类 中 


从 WavReader 中 调用 Snippet 
代码 , 
将 dataLength 复 制 过 来 
#include Snippet.h 
using namespace std; 


加 入 新 的 前 提 目 标 并 且 没有 导致 失败 , 这 本 身 并 没有 错误 , 但 这 和 写 一 个 自动 通过 的 测试 有 
点 类 似 。 早 前 ,我 们 选择 复制 代码 至 Snippet 类 。 或 许 我 们 应 当 着 重 关注 这 个 问题 ， 并 坚持 将 移动 
方法 作为 更 直接 的 目标 。 


无 论 如 何 ， 我 们 选择 继续 前 进 。 由 于 测试 原因 ， 尝 试 将 函数 从 WavReader 中 移 除 失败 了 。 我 
们 加 上 一 个 前 提 目 标 ， 修 掉 测 试 ， 勾 选 这 个 前 提 ， 然 后 成 功 地 将 函数 从 WavReader 中 移 除 ， 任 务 
完成 ! (可 以 为 修复 测试 创建 一 个 前 提 目 标 ， 但 现在 你 无 疑 已 经 一 览 全 局 了 。) 


你 可 以 在 源码 包 中 找到 最 终 的 代码 ,重要 的 是 要 保证 最 后 一 个 勾 选 画 在 了 图 中 的 Mikado 目 标 
E! (参见 下 文中 的 插图 。) 


从 设计 的 角度 来 看 ， 我 们 处 于 较 好 的 境地 。WavReader 主 要 用 于 读 取 WAV 文 件 ，Snippet 主 
要 用 于 从 WAV 文 件数 据 写 出 片段 。 之 前 我 们 还 担忧 暴露 本 该 私有 的 函数 ( 如 writeSnippet() )。 
现在 它们 已 经 是 Snippet 的 公有 接口 了 ， 我 们 的 担忧 也 就 一 扫 而 空 。 当 然 ， 我 们 还 可 以 进一步 修 
改 , 但 这 一 直 都 会 存在 。 就 目前 来 讲 ， 作 为 一 个 增 量 的 改进 ， 这 已 经 足够 好 了 ， 我 们 可 以 继续 


y 


前 进 。 

















向 Snippet 中 加 入 构造 国 数 变 
量 和 成 员 函 数 变量 
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从 WavReader 中 移 除 
函数 


通过 复制 代码 构建 新 的 
Snippet 类 








将 Snippet 代 码 提取 到 
一 个 新 的 类 中 


从 WavReader 中 调用 
Snippet 代 码 
#include Snippet.h i 


8.20 ”有 关 Mikado 方法 的 更 多 思考 


正如 前 一 章 示 例 显示 的 那样 ， 即 便 是 一 个 很 小 的 重 构 ， 也 很 容易 让 人 迷失 方向 、 丢 三 落 四 。 
构建 Mikado 图 有 助 于 了 解 你 从 哪里 来 、 要 往 哪里 去 。 


回溯 的 工作 方式 是 Mikado 方 法 的 重要 部 分 。 相反 ,典型 的 方法 会 顺 着 代码 , 朝 着 有 点 模糊 的 
最 终日 标 尝试 重 构 。 只 有 达成 目标 后 ， 你 才能 对 解决 方案 有 粗略 的 印象 。 


前 向 方法 让 你 可 以 完成 你 想 要 完成 的 , 但 这 种 随意 的 方法 会 带 来 一 些 问 题 , 很 容易 出 现 一 无 
所 获 的 代码 改动 。 此 时 ,你 会 拒绝 重头 开始 ， 因 为 这 需要 回顾 目前 为 止 走 过 的 每 一 步 。 大 多 数 时 
候 ， 你 会 选择 艰难 地 前 行 ， 这 可 能 会 将 不 理想 的 代码 留 在 原 地 。 


如 前 文 所 述 , 有 时 你 只 能 到 达 距 最 终 目 标 一 半路 程 的 地 方 , 并 被 强制 丢弃 没有 完成 的 解决 方 
案 。 不 完整 的 重 构 工 作 会 让 代码 看 起 来 令 人 迷惑 。 


在 一 个 需要 几 天 或 更 长 时 间 才能 完成 的 大 型 重 构 工 作 中 , Mikado 方 法 能 发 挥 重 要 作用 。 因 为 
大 部 分 时 间 都 在 探索 和 分 析 , 所 以 你 可 以 将 真正 的 工作 提炼 成 简单 的 脚本 ,并 体现 在 Mikado 图 中 。 
此 外 , 不 断 地 尝试 各 种 解决 方案 以 及 在 遇 到 问题 时 及 时 回 深 代 码 意 味 着 , 在 方案 中 重新 实施 之 前 
的 步骤 可 以 提升 效率 。( 在 构建 Mikado 图 时 ， 可 以 加 上 一 些 有 用 的 代码 段 。) 


如 果 拥 有 一 个 完整 且 经 过 良好 实践 的 Mikado 图 ,那么 就 能 将 经 过 几 周 探索 分 析 得 来 的 信息 提 
炼 为 耗 时 儿 个 小 时 的 脚本 。 随 后 ,你 可 以 应 用 这 个 脚本 来 实施 巨大 的 、 遍 及 整个 系统 的 改动 。 你 
告诉 团队 成 员 要 确保 在 下 班 前 做 好 代码 整合 并 提交 ,然后 应 用 这 个 脚本 ,如 果 遇 到 问题 , 最 坏 的 
情况 就 是 回 滚 代码 。 你 的 同事 在 第 二 天 早上 就 能 获取 你 提交 的 大 规模 改动 。 这 样 你 的 工作 对 他 们 

















将 dataLength 和 
writeSamples 复 制 过 来 


using namespace std; 


中 标记 的 Mikado 目 标 










向 Snippet 中 加 入 构造 函 
数 变 量 和 成 员 函 数 变量 
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来 说 影响 会 很 小 ， 反 之 亦 然 。 


你 已 经 了 解 了 Mikado 方 法 的 核心 步骤 。 但 是 ， 我 强烈 建议 你 进一步 学 习 此 技巧 。Mikado 方 
法 的 书籍 (Behead You Legacy Beast: Refactor and Restructure Relentlessly with the Mikado Method 
[BE12]) 能 够 提供 任何 你 想 知道 的 知识 。 同 时 ， 它 还 罗列 了 应 对 遗留 系统 的 精彩 原则 总 结 。 








8.21 这 样 做 值得 吗 

在 经 历 了 本 章 的 遗留 代码 示例 后 ,你 可 能 会 想 :“ 天 呐 ! 要 做 这 么 多 事 ! 为 什么 要 这 么 做 呢 ? ” 

你 已 经 知道 不 这 么 做 的 代价 了 。 系 统 自 身 缓慢 、 明 确 的 退化 无 疑 会 让 你 痛苦 倍增 。 构建 系统 
的 时 间 变 长 、 分 析 时 间 变 长 、 需 要 更 多 的 时 间 运 行 测 试 ， 并 且 维 护 时 间 也 在 变 长 。 

只 要 能 获得 支持 并 专注 于 系统 , 使 用 ( 包括 本 章 中 介绍 的 ) 遗留 代码 管理 技巧 就 可 以 挽救 系 
统 。 最 初 的 努力 可 能 只 会 给 代码 库 带 来 很 小 的 影响 。 但 如 果 每 个 人 都 秉承 做 出 增 量 改 进 的 目标 ， 
就 能 开始 看 到 改动 带 来 的 巨大 回报 。( 需要 多 长 时 间 呢 ? 这 取决 于 系统 的 大 小 、 修 改 的 速度 、 代 
码 的 难度 、 团 队 的 意愿 ， 等 等 。) 

你 的 团队 必须 作出 选择 : 要 么 弃 用 遗留 系统 挽救 技巧 ， 并 任 系统 持续 退化 ( 这 是 确定 的 ); 
要 么 放手 一 搏 , 决定 让 事情 往 好 的 方向 发 展 。 如 果 选 择 后 者 ,那么 你 就 要 帮助 团队 列 出 一 些 基本 
规则 ， 以 便 衡量 对 每 次 提交 的 改动 的 期 望 。 
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令 人 旦 惧 的 遗留 代码 可 以 吓 跑 最 好 的 开发 者 。 你 在 本 章 中 再 一 次 学 到 , 用 增 量 的 方法 处 理 问 
题 非常 奏效 。 只 要 做 少量 的 安全 代码 重组 ， 你 就 能 保持 前 进 。 不 需要 测试 所 有 的 东西 ， 只 要 测试 
需要 改动 的 部 分 即 可 。 


同时 ,你 也 学 到 了 怎样 通过 Mikado 方 法 做 出 巨大 、 壳 及 整个 系统 的 改动 , 而且 不 用 承担 很 大 
的 心理 压力 。 

在 下 一 章 中 , 你 将 学 习 如 何 用 TDD 来 帮助 应 对 软件 开发 中 难度 更 大 的 挑战 之 一 , 即 怎样 打造 
健壮 的 多 线程 应 用 程序 。 



































测试 驱动 开发 与 多 线程 








9.1 开场 白 
创建 一 个 健壮 的 多 线程 应 用 是 一 项 挑战 , 需要 花费 几 个 小 时 甚至 几 天 的 时 间 来 解决 竞争 条 件 
和 死 锁 问题 。 能 用 测试 驱动 的 方式 开发 这 样 的 应 用 程序 吗 ? 


答案 是 肯定 的 , 但 是 编写 处 理 多 线程 的 测试 并 不 容易 。 有 时 ,这 些 测试 本 身 就 会 产生 大 量 额 
外 的 线程 ， 从 而 在 系统 中 增加 了 并 发 复杂 性 的 层面 。 















































9.2 测试 驱动 开发 多 线程 应 用 的 核心 概念 
在 本 章 中 ， 你 将 通过 一 个 示例 程序 来 了 解 TDD 多 线程 应 用 的 相关 核心 概念 。 


分 离线 程 逻 辑 和 程序 逻辑 。 最 好 的 面向 对 象 的 设计 是 尽 可 能 地 分 离 各 种 关注 点 。 多 线程 应 用 
程序 设计 也 不 例外 。 多 线程 是 一 个 关注 点 , 应 用 程序 逻辑 是 另 一 个 关注 点 。 要 尽 可 能 地 分 离 这 些 
关注 点 ， 并 将 耦合 降 到 最 低 。 重 申 一 下 ， 小 的 方法 和 类 是 最 好 的 解决 办 法 〈 人 参见 6.2.6 节 )。 


休眠 并 不 好 ， 对 吧 ? 在 线程 中 通过 调用 steep_for() 和 暂停 执行 ， 直 到 满足 相应 的 条 件 ， 是 一 
种 粳 糕 的 解决 方案 。 测 试 的 运行 会 变 慢 , 还 会 引发 随机 错误 。 对 失败 的 定时 需 测 试 的 反应 通常 是 增 
加 等 待 时 间 ， 这 会 使 测试 的 平均 运行 时 间 变 长 ， 更 糟糕 的 是 ， 真 正 的 问题 会 被 隐藏 得 更 深 、 更 久 。 

简化 特定 的 应 用 测试 至 单线 程 。 在 引入 多 线程 之 前 , 应 用 程序 代码 首先 必须 能 够 在 单线 程 环 
境 下 工作 。 一 旦 引入 多 线程 ， 仍 然 要 确保 应 用 程序 代码 能 正确 地 执行 。 

为 特定 的 应 用 测试 提供 消除 并 发 性 的 方法 ,可 以 帮助 你 保持 清醒 。 从 某 种 意义 上 来 说 , 测试 
多 线程 代码 将 带 你 进入 集成 测试 的 领域 .为 了 重 载 线程 控制 , 你 可 以 在 应 用 程序 中 加 入 钧 子 机 制 ， 
或 引入 更 多 的 测试 。 

在 引入 并 发 性 控制 之 前 ， 验 证 并 发 性 问题 。 在 程序 中 滥用 并 发 控制 (Lock 和 Wait ) 会 极 大 降 
低 应 用 程序 的 性 能 , 甚至 有 可 能 解决 不 了 任何 真正 的 并 发 性 问题 。 接 下 来 的 示例 程序 主要 包含 了 
以 下 核心 内 容 : 先 编写 一 个 可 以 演示 潜在 并 发 性 问题 的 测试 ; 然后 使 其 恶化 , 直到 测试 每 次 都 会 
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和 失败。 通过 演示 这 些 失败 ， 首 先 能 确保 继续 保持 测试 驱动 的 模式 。 你 需要 做 的 仅仅 是 增加 并 发 性 
控制 ， 以 便 测 试 可 以 通过 。 


以 测试 驱动 的 方式 应 对 多 线程 所 带 来 的 挑战 , 仍然 需要 我 们 细致 地 思考 和 分 析 线 程 间 是 如 何 
交错 运行 的 。 遵 循 前 面 提 到 的 理念 可 将 麻烦 降 到 最 低 ， 从 而 产生 更 加 清晰 的 解决 方案 。 


HF 





9.3 示例 程序 GeoServer 


GeoServer 为 客户 端 应 用 程序 提供 了 一 些 支 持 ， 以 跟踪 大 量 用 户 的 地 理 位 置 (不 用 担心 ， 这 
个 应 用 程序 不 会 出 售 给 政府 ， 而 且 没 有 你 的 允许 ,我 是 不 会 泄露 你 的 位 置信 息 的 )。 典 型 的 客户 
端 应 用 是 基于 地 网 的 手机 应 用 程序 。 我 们 主要 讨论 如 何 搭建 服务 器 端 应 用 , 所 以 你 完全 可 以 自己 
想象 客户 端 应 用 的 模样 。 


客户 端 应 用 注册 到 服务 器 端 , 并 开始 跟踪 用 户 的 位 置 。 客 户 端 会 不 时 地 将 位 置 更 新 信息 发 
至 服务 需 端 。 
以 下 是 GeoServer 的 源 代 码 ( 包括 Location 类 的 头 文件 ) : 















































c9/1/GeoServerTest.cpp 

#include "CppUTest/TestHarness.h" 
#include "CppUTestExtensions.h" 
#include "GeoServer.h" 


using namespace std; 


TEST GROUP(AGeoServer) { 
GeoServer server; 


const string aUser("auser"); 
const double LocationTolerance(0.005); 
u 
TEST(AGeoServer, TracksAUser) ( 
server.track(aUser); 


CHECK TRUE(server.isTracking(aUser)); 
} 


TEST(AGeoServer, IsNotTrackingAUserNotTracked) { 
CHECK FALSE(server.isTracking(aUser)) 
} 


TEST(AGeoServer, TracksMultipleUsers) { 
server.track(aUser); 
server.track("anotheruser"); 


CHECK FALSE (server.isTracking("thirduser")); 
CHECK TRUE(server.isTracking(aUser)); 
CHECK TRUE(server.isTracking("anotheruser")); 
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TEST(AGeoServer, IsTrackingAnswersFalseWhenUserNoLongerTracked) { 
server.track(aUser); 
server.stopTracking(aUser); 


CHECK FALSE(server.isTracking(aUser)); 


TEST(AGeoServer, UpdatesLocationOfUser) ( 
server.track(aUser); 
server.updateLocation(aUser, Location(38, -104]); 


auto location = server.locationOf(aUser); 
DOUBLES EQUAL(38, location.latitude(), LocationTolerance); 
DOUBLES EQUAL(-104, location.longitude(), LocationTolerance); 


TEST(AGeoServer, AnswersUnknownLocationForUserNotTracked) { 
CHECK TRUE(server.locationOf("anAbUser").isUnknown()); 


TEST(AGeoServer, AnswersUnknownLocationForTrackedUserWithNoLocationUpdate) { 
server.track(aUser); 
CHECK TRUE(server.locationOf(aUser).isUnknown()); 


TEST(AGeoServer, AnswersUnknownLocationForUserNoLongerTracked) 1 
server.track(aUser); 
server.updateLocation(aUser, Location(40, 100)); 
server.stopTracking(aUser); 
CHECK TRUE(server.locationOf(aUser).isUnknown()); 


c9/1/GeoServer.h 


#ifndef GeoServer h 
define GeoServer h 


#incLude «string» 
#include «unordered map» 


#include "Location.h" 


class GeoServer { 
public: 
void track(const std::string& user); 
void stopTracking(const std::string& user); 
void updatelocation(const std::string& user, const Location& location); 


bool isTracking(const std::string& user) const; 
Location locationOf(const std::string& user) const; 


private: 
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std::unordered map«cstd::string, Location» locations ; 


std::unordered map«std::string, Location»::const iterator 
find(const std::string& user) const; 


}; 


#endif 


c9/1/GeoServer.cpp 


#include "GeoServer.h" 

#include "Location.h" 

using namespace std; 

void GeoServer::track(const string& user) ( 
locations [user] = Location(); 


} 


void GeoServer::stopTracking(const string& user) { 
locations .erase(user); 


bool GeoServer::isTracking(const string& user) const ( 
return find(user) !- locations .end(); 


} 


void GeoServer::updateLocation(const string& user, const Location& location) { 
locations [user] = location; 

} 

Location GeoServer::locationOf(const string& user) const { 
if (!isTracking(user)) return Location(); // TODO: 性 能 开销 ? 
return find(user)-»second; 


std::unordered map«sstd::string, Location»::const iterator 
GeoServer::find(const std::string& user) const { 
return locations .find(user); 


c9/1/Location.h 


#ifndef Location h 
define Location h 


#include «limits» 
#include «cmath» 
#include «ostream» 


const double Pi{ 4.0 * atan(1.0) }; 

const double ToRadiansConversionFactor( Pi / 180 }; 
const double RadiusOfEarthInMeters( 6372000 }; 
const double MetersPerDegreeAtEquator( 111111 j; 


const double North( 0 }; 
const double West{ 90 }; 
const double South( 180 }; 
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const double East{ 270 ); 
const double CloseMetersi( 3 ); 


class Location 1 
public: 
Location(); 
Location(double latitude, double longitude); 


inline double toRadians(double degrees) const ( 
return degrees * ToRadiansConversionFactor; 


H 


inline double toCoordinate(double radians) const ( 
return radians * (180 / Pi); 


H 


inline double latitudeAsRadians() const { 
return toRadians(latitude ); 


} 


inline double longitudeAsRadians() const { 
return toRadians(longitude ); 


H 


double latitude() const; 
double longitude() const; 


bool operator--(const Location& that); 
bool operator!-(const Location& that); 


Location go(double meters, double bearing) const; 
double distancelInMeters(const Location& there) const; 
bool isUnknown() const; 

bool isVeryCloseTo(const Location& there) const; 


private: 
double latitude ; 
double longitude ; 


double haversineDistance(Location there) const; 


h 
std::ostream& operator««(std::ostream& output, const Location& location); 


#endif 


你 可 以 参考 未 列 在 这 里 的 其 他 源 代码 文件 。 咽 …… 注意 文件 GeoServer.cpp 中 的 一 段 注释 ! 有 
人 担心 两 次 访问 Locations 地 图 会 增加 性 能 开销 。 我 们 稍 后 再 讨论 这 个 问题 (参见 10.2 节 )。 


有 了 这 些 基 本 的 素材 ， 现 在 我 们 来 着 手 充 实 GeoServer 吧 。 
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mi 搜索 附近 的 用 户 
作为 客户 端 用 户 , 我 希望 能 够 标识 出 地 图 上 某 个 适 形 区 域内 的 所 有 用 户 ( 包括 他 们 
的 坐标 )， 这 样 就 能 知道 他 们 在 地 图 上 的 位 置 了 。 


我 们 将 在 GeoServer 中 实现 这 一 点 。 


c9/2/GeoServerTest.cpp 


TEST GROUP (AGeoServer UsersInBox) { 
GeoServer server; 


const double TenMeters { 10 }; 
const double Width ( 2000 + TenMeters j; 
const double Height ( 4000 + TenMeters}; 
const string aUser { "auser" }; 
const string bUser ( "buser" }; 
const string cUser ( "cuser" }; 


Location aUserLocation { 38, -103 }; 


void setup() override ( 
server.track(aUser); 
server.track(bUser); 
server.track(cUser); 
server.updateLocation(aUser, aUserLocation); 
} 
vector<string> UserNames (const vector<User>& users) { 
return Collect<User,string>(users, [](User each) { return each.name(); }); 


h 
TEST(AGeoServer UsersInBox, AnswersUsersInSpecifiedRange) { 
server.updateLocation( 
bUser, Location([aUserLocation.go(Width / 2 - TenMeters, East))); 
auto users - server.usersInBox(aUser, Width, Height); 
CHECK EQUAL(vector«string» ( bUser }, UserNames(users)); 
TEST(AGeoServer UsersInBox, AnswersOnlyUsersWithinSpecifiedRange) { 
server.updateLocation( 


bUser, Location([aUserLocation.go(Width / 2 + TenMeters, East)}); 


server.updateLocation( 
cUser, Location([aUserLocation.go(Width / 2 - TenMeters, East)]); 


auto users - server.usersInBox(aUser, Width, Height); 


CHECK EQUAL(vector«string» ( cUser }, UserNames(users)); 





210 — $93 测试 驱动 开发 与 多 线程 





c9/2/GeoServer.cp 


bool GeoServer::isDifferentUserInBounds( 
const paircstring, Location»& each, 
const string& user, 
const Area& box) const { 
if (each.first == user) return false; 
return box.inBounds(each.second); 


vector«User» GeoServer::usersInBox( 
const string& user, double widthInMeters, double heightInMeters) const { 
auto location - locations .find(user)-»second; 
Area box ( location, widthInMeters, heightInMeters }; 


vector«User» users; 
for (auto& each: locations ) 
if (isDifferentUserInBounds(each, user, box)) 
users.push back(User([each.first, each.second])); 
return users; 


) 


Area 表 示 以 某 个 位 置 为 中 心 的 矩形 区 域 ， 能 够 表明 该 区 域 是 否 包 含 了 一 个 (或 其 他 ) 位 置 。 
以 下 是 Area 的 头 文件 。 











c9/2/Area.h 


#ifndef Area h 
define Area h 


#include "Location.h" 


class Area { 
public: 
Area(const Location& location, double width, double height); 
Location upperLeft() const; 
Location upperRight() const; 
Location lowerRight() const; 
Location lowerLeft() const; 
bool inBounds(const Location&) const; 


private: 
double left ; 
double right ; 
double top ; 
double bottom ; 
}; 


#endif 


User 包 含 了 用 户 的 名 字 和 位 置信 息 。 





c9/2/User.h 
#ifndef User h 
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#define User h 
*include "Location.h" 


class User { 
public: 
User(const std::string& name, Location location) 
: name (name), location (location) {} 
std::string name() ( return name ; } 
Location location() { return location ; } 


private: 
std::string name ; 
Location location ; 
}; 
#endif 


9.4 性 能 要 求 

我 们 面临 性 能 方面 的 考验 。 产品 负责 人 指出 我 们 期 望 大 量 的 用 户 。 初 始 发 行 版 本 应 该 可 以 同 
时 支持 50 000 位 用 户 。 

我 们 编写 了 一 个 测试 ， 以 模拟 将 用 户 数目 逐步 增加 至 巨大 数量 级 的 情况 。 



































c9/3/GeoServerTest.h 


TEST(AGeoServer UsersInBox, HandlesLargeNumbersOfUsers) ( 
Location anotherLocation([aUserLocation.go(10, West)}; 
const unsigned int lots (500000); 
for (unsigned int i(0); i « lots; i++) ( 

string user("user" + to string(i)); 
server.track(user); 
server.updateLocation(user, anotherLocation); 


H 


auto users - server.usersInBox(aUser, Width, Height); 
CHECK EQUAL(lots, users.size()); 
} 
当 运 行 测 试 时 ， 我 们 注意 到 ， 在 CppUTest 执 行 HandlesLargeNumbersOfUsers 时 存在 约 1.5 秒 
的 停顿 。 虽 然 看 起 来 并 不 长 ， 但 这 仅仅 只 是 一 个 测试 。 一 个 系统 中 最 终 可 能 会 有 成 千 上 万 个 测 
试 ， 即 便 只 有 少量 运行 缓慢 的 测试 ， 但 也 会 阻碍 你 按照 必要 的 频率 来 运行 这 些 测试 。 我 们 并 不 
想 在 快速 测试 集中 运行 较 慢 的 HandlesLargeNumbersOfUsers 测 试 ,但 我 们 将 来 仍然 有 可 能 需要 运 
行 它 。 完成 清理 工作 之 后 , 最 好 的 措施 就 是 将 HandlesLargeNumbersOfUsers 移 到 运行 较 慢 的 其 他 
测试 集中 。 
代码 看 起 来 运行 得 很 慢 , 但 我 们 能 确定 这 个 测试 运行 得 特别 慢 四 ?现在 通过 CppUTest 的 选项 
-v 来 重新 运行 测试 。 


build/utest -v 
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测试 运行 的 输出 结果 证 明 新 测试 是 罪魁 祸首 。 








E 


TEST(ALocation, ProvidesPrintableRepresentation) - 0 ms 

TEST(ALocation, IsNotVeryCloseToAnotherWhenNotSmallDistanceApart) - 0 ms 
TEST(ALocation, IsVeryCloseToAnotherWhenSmallDistanceApart) - 0 ms 

TEST(ALocation, CanBeAPole) - 0 ms 

TEST(ALocation, AnswersNewLocationGivenDistanceAndBearingVerifiedByHaversine) - 0 ms 
TEST(ALocation, AnswersNewLocationGivenDistanceAndBearing) - 0 ms 


TEST(ALocation, IsNotEqualToAnotherWhenLatAndLongMatch) - 0 ms 
TEST(ALocation, IsNotEqualToAnotherWhenLongDiffers) - 0 ms 
TEST(ALocation, IsNotEqualToAnotherWhenLatDiffers) - 0 ms 
TEST(ALocation, AnswersDistanceFromAnotherInMeters) - 0 ms 
TEST(ALocation, IsUnknownWhenLatitudeAndLongitudeNotProvided) - 0 ms 
TEST(ALocation, IsNotUnknownWhenLatitudeAndLongitudeProvided) - 0 ms 
TEST(ALocation, AnswersLatitudeAndLongitude) - 0 ms 

» TEST(AGeoServer UsersInBox, HandlesLargeNumbersOfUsers) - 1689 ms 
TEST(AGeoServer UsersInBox, AnswersOnlyUsersWithinSpecifiedRange) - 0 ms 
4 ... (results of other tests omitted) 


OK (39 tests, 39 ran, 49 checks, 0 ignored, 0 filtered out, 1798 ms) 

我 们 仍然 不 知道 真正 的 问题 在 于 调用 usersInBox( ) 。 或 许 问题 在 于 测试 中 用 于 跟踪 和 更 新 
50 万 用 户 位 置信 息 的 Arrange 部 分 。 我 们 需要 更 精确 的 测量 。 

作为 临时 的 调查 方案 ,我们 在 测试 HandlesLargeNumbersOfUsers 中 声明 一 个 RA 定时 器 的 实 
例 。( 要 想 了 解 更 多 关于 TestTimer 类 的 信息 ， 参 见 10.2 节 。) 











c9/4/GeoServerTest.cpp 
TEST(AGeoServer UsersInBox, HandlesLargeNumbersOfUsers) { 
Location anotherLocation(aUserLocation.go(10, West)}; 
const unsigned int lots (500000); 
for (unsigned int i{0}; i < lots; i++) ( 
string user("user" + to string(i)); 
server.track(user); 
server.updateLocation(user, anotherLocation); 
} 
» TestTimer timer; 
auto users - server.usersInBox(aUser, Width, Height); 


CHECK EQUAL(lots, users.size()); 
} 


通过 调查 方案 得 知 , 每 次 调用 usersInBox() 平 均 要 花费 200 多 毫秒 ( 多 次 运行 测试 以 确保 数 
据 的 可 靠 性 )。 


HandlesLargeNumbersOfUsers elapsed time = 219.971ms 





OK (39 tests, 39 ran, 49 checks, 0 ignored, 0 filtered out, 1823 ms) 


我 们 提醒 自己 ,这 些 信 息 是 相对 的 ,不同 机 器 上 的 运行 结果 可 能 大 不 相同 , 但 这 已 足够 说 明 
有 问题 存在 。 
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虽然 200 毫 秒 没有 一 秘 或 半 秒 那么 严重 ， 但 产品 负责 人 对 此 并 不 满意 。 我 们 和 她 讨论 各 种 可 
行 方案 ， 一 起 构造 出 一 个 可 以 满足 需求 的 场景 。 





景 : 搜索 附近 用 户 是 一 个 异步 的 需求 
作为 客户 端 用户 ， 我 期 望 “ 搜 索 附 近 用 户 ” 的 需求 能 够 迅速 得 到 反馈 。 我 想 逐 个 地 
收 到 附近 用 户 的 信息 ， 每 收 到 一 个 就 在 地 图 上 显示 出 来 。 
你 可 能 已 经 意识 到 这 些 场景 并 非 是 技术 上 的 。 现存 的 指导 方针 将 避免 创建 不 对 商业 提供 可 验 
证 价值 的 场景 。 “创建 数据 库 表 单 ” 或 “升级 编译 器 版 本 ”这 样 的 任务 可 能 是 最 基本 的 ， 但 你 应 
该 只 在 商业 需求 的 环境 执行 。 有 必要 从 技术 角度 为 上 述 场景 讨论 出 一 个 解决 方案 , 上 且 它 代 表 可 以 
传递 可 论证 和 可 检验 的 商业 价值 的 特性 。 


















































9.5 设计 异步 方案 

通过 测试 驱动 的 方式 开发 程序 , 你 将 会 得 到 一 个 完全 不 同 于 初始 构想 的 设计 方案 。 但 这 并 不 
是 完全 放弃 预先 设计 的 理由 。 通 常情 况 下 ， 你 希望 可 以 基于 提供 合理 方向 的 路 线 图 开展 工作 。 

不 要 花 太 多 时 间 来 增加 路 线 图 的 细节 ， 因 为 在 向 前 行进 时 , 我 们 毫 无 疑问 要 走 一 些 计 路。 路 
线 图 中 包含 过 多 细节 却 最 终 没 有 执行 的 部 分 完全 是 在 浪费 时 间 。 

GeoServer 窜 户 端 需要 简单 的 接口 ， 用 于 将 用 户 信 息 、 高 度 、 宽 度 传送 给 服务 器 ， 并 从 服务 
器 得 到 用 户 清单 。 然 而 ， 为 了 支持 异步 的 用 户 体 验 ， 客 户 端 需要 向 服务 器 端 传递 一 个 回调 函数 ， 
以 便 处 理 某 个 区 域内 接受 的 所 有 用 户 信息 。 

我 们 想 要 分 离 客 户 端 和 多 线程 的 实现 细节 ， 以 下 是 我 们 提议 的 设计 思路 。 

口 为 每 一 个 连接 需求 创建 一 个 工作 项 ， 并 将 其 加 入 到 工作 队列 中 。 该 工作 项 包含 了 用 来 判 

断 用 户 是 否 处 在 某 个 区 域内 的 所 有 信息 。 

口 在 GeoServer 端 启动 一 个 或 多 个 工作 线程 。 处 于 空闲 状态 的 工作 线程 会 等 待 工作 队列 中 可 
用 的 工作 项 。 一 旦 抓 取 了 一 个 工作 项 ， 工 作 线程 就 会 开始 处 理 该 工作 项 。 

可 以 对 GeoServer 类 中 的 所 有 逻辑 进行 直接 编码 ， 但 我 们 不 会 这 么 做 。 如 果 将 多 线程 和 应 用 
程序 逻辑 杂 迷 ,一旦 出 现 问题 ,那么 将 会 是 一 个 漫长 且 邻 人 厌恶 的 调 斌 过程。 而且， 几乎 所 有 程 
序 都 会 出 现 问题 。 

因此 ， 我 们 分 离 涉 及 的 三 个 关注 点 ， 并 用 三 个 类 来 表征 : 
O Work 类 ， 表 示 一 个 工作 项 ; 

口 ThreadPool 类 ， 用 于 创建 工作 线程 并 处 理工 作 队 列 ; 
口 GeoServer 类 ， 用 于 创建 Work 对 象 ， 并 将 其 发 送 到 ThreadPool 以 便 让 其 执行 。 


先 从 最 简单 的 Work 类 开始 : 
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c9/5/WorkTest.cpp 


#include "CppUTest/TestHarness.h" 
#include "Work.h" 

#include «functional» 

Xinclude «vector» 

#include «sstream» 


using namespace std; 


TEST GROUP(AWorkObject) ( 


H 
TEST(AWorkObject, DefaultsFunctionToNullObject) { 
Work work; 
try ( 
work.execute(); 
} 
catch(...) { 
FAIL("unable to execute function"); 
} 


} 


TEST(AWorkObject, DefaultsFunctionToNullObjectWhenConstructedWithId) { 
Work work(1); 
try 1 
work.execute(); 
} 
catch(...) { 
FAIL("unable to execute function"); 
} 
j 


TEST(AWorkObject, CanBeConstructedWithAnId) { 
Work work(1); 
LONGS EQUAL(1, work.id()); 


TEST(AWorkObject, DefaultsIdToO) ( 
Work work; 
LONGS EQUAL(0, work.id()); 
} 
TEST(AWorkObject, DefaultsIdToOWhenFunctionSpecified) { 
Work work{[]{}}; 
LONGS EQUAL(0, work.id()); 


TEST(AWorkObject, CanBeConstructedWithAFunctionAndId) { 
Work work{[]{}, 1}; 
LONGS_EQUAL (1, work.id()); 

j 


TEST(AWorkObject, ExecutesFunctionStored) { 
bool wasExecuted[(false); 
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auto executeFunction = [&] () { wasExecuted = true; }; 
Work work(executeFunction); 

work.execute(); 

CHECK TRUE(wasExecuted); 


TEST(AWorkObject, CanExecuteOnDataCapturedWithFunction) { 

vector<string> data["a", "b"); 

string result; 

auto callbackFunction = [&](string s) ( 
result.append(s); 

}; 

auto executeFunction = [&]() { 
stringstream s; 
s << data[0] << data[1]; 
callbackFunction(s.str()); 

}; 

Work work(executeFunction); 

work.execute(); 

CHECK EQUAL("ab", result); 


c9/5/Work.h 


#ifndef Work h 
define Work h 
#include «functional» 


class Work { 
public: 
static const int DefaultId(0); 
Work(int id-DefaultId) 
: id (id) 
, executeFunction {[]{}} {} 
Work(std::function«void()» executeFunction, int id-DefaultId) 
: id (id) 
, executeFunction (executeFunction) 
{} 
void execute() { 
executeFunction (); 
} 


int id() const { 


ie 59 9 
} 


private: 
int id_; 
std: :function<void()> executeFunction ; 





}; 
#endif 





基于 Work 类 的 测试 CanExecuteOnDataCapturedWithFunction 仅 仅 展 示 了 lambda 是 如 何 工作 
的 ， 从 技术 角度 来 说 ， 这 并 不 是 必需 的 。 测 试 很 快 就 通过 了 。 这 个 测试 将 帮助 我 们 加 强 理 解 如 何 
使 用 lambda， 并 可 以 演示 客户 端 代码 会 如 何 利用 Work 类 对 象 。 函 数 executeFunction 的 功能 是 
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抓 取 本 地 定义 的 数据 向 量 , 并 随后 演示 这 些 数据 的 处 理 。( 截取 操作 符 [&] 告诉 C++ 编译 顺 通 过 引 
用 来 抓 取 任 何 参考 变量 。) 这 个 函数 也 能 获取 本 地 定义 的 回调 函数 caLLbackFunction, 并 将 数据 
向 量 元 素 的 联接 结果 发 送 到 该 回调 函数 。 

我 们 最 终 会 删除 CanExecuteOnDataCapturedWithFunction 测 试 。 当 理解 了 如 何 用 GeoServer 代 
码 创建 Work 类 对 象 时 ， 它 将 提供 一 个 我 们 要 做 的 示例 程序 。 
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我 们 开始 着 手 设 计 ThreadPool 类 。 在 引入 多 线程 之 前 ， 先 通过 测试 驱动 的 方式 开发 一 些 处 理 
用 户 需求 的 模块 。 





c9/5/ThreadPoolTest.cpp 


#include "CppUTest/TestHarness.h" 
include "ThreadPool.h" 


using namespace std; 


TEST GROUP(AThreadPool) ( 
ThreadPool pool; 
H 


TEST(AThreadPool, HasNoWorkOnCreation) { 
CHECK FALSE (pool.hasWork()); 
} 


TEST(AThreadPool, HasWorkAfterAdd) { 
pool.add(Work()); 
CHECK TRUE(pool.hasWork()); 

} 


TEST(AThreadPool, AnswersWorkAddedOnPull) { 
pool.add(Work(1)); 
auto work = pool.pullWork(); 


LONGS EQUAL(1, work.id()); 
} 


TEST(AThreadPool, PullsElementsInFIFOOrder) { 
pool.add(Work(1)); 
pool.add(Work(2)) ; 
auto work = pool.pullWork(); 


LONGS EQUAL(1, work.id()); 
} 


TEST(AThreadPool, HasNoWorkAfterLastElementRemoved) { 
pool.add(Work()); 
pool.pullWork(); 
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CHECK FALSE (pool.hasWork()); 
} 


TEST(AThreadPool, HasWorkAfterWorkRemovedButWorkRemains) { 
pool.add(Work(])); 
pool.add(Work(])); 
pool.pullWork(); 
CHECK TRUE(pool.hasWork()); 


c9/5/ThreadPool.h 


#ifndef ThreadPool h 
define ThreadPool h 


#include «string» 
#include «deque» 
#include "Work.h" 


class ThreadPool { 
public: 
bool hasWork() 1 
return !workQueue .empty(); 


H 


void add(Work work) { 
workQueue .push front(work); 


H 


Work pullWork() { 
auto work = workQueue .back(); 
workQueue .pop back() 
return work; 








H 
private: 
std::deque«Work» workQueue ; 
}; 
#endif 
测试 AnswersWorkAddedOnPull 必 须 验 证 抓 取 的 工作 项 和 增加 的 工作 项 是 相互 匹配 的 。 或 许 
可 以 比较 地 址 ， 但 我 们 决定 为 Work 对 象 增加 一 个 身份 标志 符 ( ID )， 从 而 让 测试 更 简洁 。 m 
c9/5/Work.h 


#ifndef Work h 
define Work h 
#include «functional» 


class Work { 
public: 
static const int DefaultId(0); 
Work(int id-DefaultId) 
: id (id) 
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, executeFunction {[]{}} {} 
Work(std::function«void()» executeFunction, int id-DefaultId) 
: id (id) 
, executeFunction (executeFunction] 
{} 
void execute() { 
executeFunction (); 
F 
int id() const { 
return id_; 
} 
private: 
int id_; 
std::function«void()» executeFunction ; 
}; 
#endif 


9.7 ”为 多 线程 做 好 准备 
( 注意 ，CppUTest 中 的 内 存 泄漏 检测 目前 不 是 线程 安全 的 。 你 可 能 想 将 其 关 掉 ， 更 多 信息 请 
参见 http:/www.cpputestorg/node/25。 关 掉 内 存 泄漏 检测 功能 会 在 第 8 章 的 编程 练习 中 引入 问题 。) 


我 们 想 让 ThreadPool 处 理 抓 取 并 执行 工作 项 。 我 们 需要 一 个 线程 。 创 建 的 测试 展示 了 如 何 将 
Work 对 象 发 送 到 ThreadPool 的 add( ) 函数 ， 并 让 线程 池 异 步 地 人 处理 Work 对 象 。 
































c9/6/ThreadPoolTest.cpp 
TEST(AThreadPool, PullsWorkInAThread) { 
pool.start(); 
condition variable wasExecuted; 
bool wasWorked10); 
Work work{[&] 1 
unique lock«mutex» lock(m); 
wasWorked = true; 
wasExecuted.notify all(); 


3H 
pool.add(work); 


unique lock«mutex» lock(m); 
CHECK TRUE(wasExecuted.wait for(lock, chrono::milliseconds(100), 
[8] { return wasWorked; })); 
} 


异步 方法 意味 着 函数 add () 可 以 在 工作 完成 之 前 ， 将 控制 权 返还 给 测试 。 我 们 需要 找到 方法 
以 验证 工作 项 是 否 被 真正 执行 ,我 们 采取 了 wait/notify 的 策略 。 当 创建 完 一 个 ThreadPool 的 实例 后 ， 
测试 程序 定义 了 一 个 条 件 变 量 wasExecuted。 这 个 信号 量 可 以 避免 测试 过 快 完成 。 

我 们 创建 了 一 个 工作 项 ， 该 工作 项 中 的 回调 函数 可 以 设置 标志 位 ， 并 通知 所 有 等 待 
wasExecuted 条 件 的 线程 。 我 们 期 望 ThreadPool 的 工作 线程 来 执行 这 个 工作 项 。 测 试 调用 poot， 
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add(work) 后 ， 它 创建 了 一 个 互 斥 锁 ， 并 一 直 等 到 相应 的 标志 位 被 设置 。 如 果 没 有 及 时 清除 条 件 
变量 ， 那 么 测试 将 会 失败 。 

在 ThreadPool 类 中 增加 函数 start () 用 来 决定 :客户 端 程序 必须 表明 ThreadPool 应 该 在 什么 时 
候 启 动 它 的 工作 线程 。 因 为 线程 不 会 在 ThreadPool 实 例 化 的 过 程 中 自动 启动 ， 所 以 ， 对 于 之 前 编 
写 的 基于 特定 应 用 程序 的 测试 , 我 们 无 需 担 心 多 线程 的 问题 。 函数 start() 启 动 了 一 个 工作 线程 ， 
一 旦 该 线程 完成 初始 化 ， 在 析 构 函数 中 将 会 调用 join()。 

函数 worker() 等 待 可 用 的 工作 项 ， 然 后 抓 取 并 执行 。 

















c9/6/ThreadPool.h 


#include «string» 
#include «deque» 
» #incLude «thread» 
> #include «memory» 


#include "Work.h" 


class ThreadPool { 
public: 


» virtual -ThreadPool() { 
» if (workThread ) 
» workThread -»join(); 
» } 
» void start() ( 
» workThread = std::make shared«std::thread»(&ThreadPool::worker, this); 
> } 
A Wat 
private: 
> void worker() { 
> while (!hasWork()) 
» ; 
» pullWork().execute(); 
» j 
std::deque«Work» workQueue ; 
» std::shared ptr«std::thread» workThread ; 


}; 
第 一 次 运行 测试 后 ， 我 们 收 到 了 一 条 错误 信息 : 


..terminate called after throwing an instance of 'std::system error' 
what(): Operation not permitted 


经 过 快速 的 网 络 搜索 及 访问 Stackoverflow.com 网 页 后 , 我 们 在 CMakeLists.txt 增 加 了 对 pthread 
的 链接 ， 从 而 消除 了 这 个 错误 。 








c9/6/CMakeLists.txt 
3E ... 
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target link libraries(utest pthread) 
» target link libraries(utest CppUTest) 











测试 有 时 能 成 功 地 运行 。 我 们 只 要 看 一 下 刻意 过 
个 命令 行 脚本 反复 运行 这 些 测试 , 你 会 发 现 新 增加 的 线程 测试 时 常会 触发 分 段 错 误 。 我 
们 将 研究 另 一 个 方案 : 用 强制 手段 让 错误 直接 源 于 测试 本 身 。 





























是 通过 








9.8 ”暴露 并 发 ' 





生 问题 


度 简化 的 实现 ,就 可 以 知道 问题 所 在 。 如 





我 们 想 进 一 步 展 示 : 工作 线程 可 以 从 工作 队列 中 抓 取 和 执行 多 个 工作 项 。 





c9/7/ThreadPoolTest.cpp 


TEST(AThreadPool, ExecutesAllWork) 1 
pool.start(); 
unsigned int count(0); 
unsigned int NumberOfWorkItemsi(3); 
condition variable wasExecuted; 
Work work{[&] 1 


std::unique lock«std::mutex» lock(m); 


++count; 
wasExecuted.notify all(); 


H; 


for (unsigned int i{0}; i < NumberOfWorkItems; i++) 


pool.add(work); 
unique_lock<mutex> lock(m); 


CHECK TRUE(wasExecuted.wait for(lock, chrono: :milliseconds (100), 
[&] { return count == NumberOfWorkItems; })); 


} 





FH 
个 





实现 中 引入 了 一 个 white 循 环 、 一 个 布尔 量 标志 位 ， 在 销毁 ThreadPool 实 例 的 时 候 ， 停 止 执 


行 whitLe 循 环 。 


c9/7/ThreadPool.h 


#include «string» 
#include «deque» 
Xinclude «thread» 
#include «memory» 
> £4include «atomic» 
#include "Work.h" 
class ThreadPool 1 
public: 
virtual -ThreadPool() { 
» done - true; 
if (workThread ) 
workThread -»join(); 
} 
EREE 
private: 
void worker() { 
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> while (!done ) { 
while (!hasWork()) 


pullwWork().execute(); 
» std::atomic«bool-» done [false]; 


std::deque«Work» workQueue ; 
std::shared ptr«std::thread» workThread ; 





}; 
遗憾 的 是 …… 不 ， 幸 运 的 是 ， 奖 脚 的 实现 每 次 都 会 导致 测试 程序 瘫痪 。 在 处 理 多 线程 时 ， 持 





续 的 错误 不 完全 是 坏事 ， 它 会 引导 出 一 个 解决 方案 。 分 析 表 明 ， 当 测试 完成 后 ，ThreadPool 的 析 
构 函 数 将 标志 位 done_ 设 为 tue， 并 尝试 加 入 线程 执行 。 而 线程 却 无 法 完成 工作 ， 因 为 它 一 直 陷 
在 while 循 环 中 ,等待 可 用 的 工作 项 。 


在 等 待 工作 项 的 循环 中 加 入 一 个 条 件 语句 ， 当 标志 位 done_ 为 true 的 时 候 ， 跳 出 当前 的 循环 。 





c9/8/ThreadPool.h 


void worker() ( 
while (!done ) { 


» while (!done && !hasWork()) 
» ; 
» if (done ) break; 
pullWork().execute(); 
} 
} 


测试 不 再 导致 系统 瘫痪 ,并 且 在 第 一 次 运行 时 就 通过 了 。 然而 , EMAA EERS 
失败 。 我 们 需要 进一步 找到 使 测试 每 次 都 失败 的 方法 。 简单 的 尝试 后 发 现 , 增加 循环 中 的 工作 项 
数目 并 不 会 带 来 什么 差别 。 测 试 需要 从 本 身 创 建 的 线程 中 增加 工作 项 。 


让 我 们 先 重 构 吧 ， 清 除 两 个 往 线程 池 中 加 入 工作 项 的 测试 。 























c9/9/ThreadPoolTest.cpp 


TEST GROUP(AThreadPool AddRequest) { 

mutex m; 

ThreadPool pool; 

condition variable wasExecuted; 

unsigned int count(0); 

void setup() override ( 
pool.start(); 

} 


void incrementCountAndNotify() { 
std::unique lock«std::mutex» lock(m); 
++count; 
wasExecuted.notify all(); 


} 
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void waitForCountAndFailOnTimeout( 
unsigned int expectedCount, 
const milliseconds& time-milliseconds(100)) { 
unique lock«mutex» lock(m); 
CHECK TRUE(wasExecuted.wait for(lock, time, 
[S] { return expectedCount == count; })); 
} 
}; 


TEST(AThreadPool AddRequest, PullsWorkInAThread) { 
Work work([&] { incrementCountAndNotify(); }}; 
unsigned int NumberOfWorkItemsi(1); 


pool.add(work); 
waitForCountAndFailOnTimeout (NumberOfWorkItems); 
j 


TEST(AThreadPool AddRequest, ExecutesAllWork) { 
Work work([&] { incrementCountAndNotify(); }}; 
unsigned int NumberOfWorkItemsi(3); 


for (unsigned int i{0}; i < NumberOfWorkItems; i++) 
pool.add(work); 


waitForCountAndFailOnTimeout (NumberOfWorkItems); 
j 


在 ThreadPool 类 中 ， 从 析 构 函数 中 抽取 部 分 代码 放 在 单独 的 函数 中 。 


c9/9/ThreadPool.h 


virtual -ThreadPool() { 
» stop(); 
} 


> void stop() { 

» done = true; 

» if (workThread ) 

» workThread -»join(); 
> } 


9.9 在 测试 中 创建 客户 端 线程 
这 次 我 们 假设 错误 是 由 围绕 工作 队列 争夺 数据 造成 的 。 主 线程 将 工作 项 加 入 到 工作 队列 中 ， 
函数 puLtwork() 将 工作 项 从 队列 中 移 除 , 且 工 作 线程 不 断 查询 工作 队列 中 是 否 有 可 用 的 工作 项 。 


我 们 的 测试 不 是 简单 的 失败 , 而 是 会 导致 分 段 错 误 。 工 作 队 列 的 并 行 更 新 看 起 来 是 一 个 疑点 。 
为 了 修补 这 个 问题 ， 我 们 先 编写 一 个 可 以 稳定 产生 同样 错误 的 测试 。 























c9/10/ThreadPoolTest.cpp 
TEST GROUP(AThreadPool AddRequest) { 
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mutex m; 

ThreadPool pool; 

condition variable wasExecuted; 
unsigned int count(0); 


» vector«shared ptr«thread»» threads; 


void setup() override ( 
pool.start(); 
} 


void teardown() override { 
for (auto& t: threads) t->join(); 
} 
IL ia 
}; 
Jf sas 
TEST(AThreadPool AddRequest, HoldsUpUnderClientStress) { 
Work work([&] { incrementCountAndNotify(); }}; 
unsigned int NumberOfWorkItemsi(10); 
unsigned int NumberOfThreads(10); 


YYVYY 


for (unsigned int i(0); i < NumberOfThreads; i++) 
threads.push back( 
make shared«thread-([&] ( 
for (unsigned int j(0); j < NumberOfWorkItems; j++) 
pool.add(work); 


})); 
waitForCountAndFailOnTimeout(NumberOfThreads * NumberOfWorkItems); 


H 

测试 通过 for 循 环 来 创建 任意 数目 的 工作 线程 。 测 试 将 线程 句柄 存储 在 向 量 中 ， 这 样 就 可 以 
正确 地 等 待 所 有 线程 结束 。 可 以 在 测试 集 的 teardown ( ) 函数 中 找到 这 些 代 码 。 

将 Nunber0fThreads 和 Number0fworkItems 设 为 1， 然 后 出 现 了 同样 的 间歇 性 错误 。 试 验 了 
一 些 组 合 后 我 们 发 现 ， 如 果 10 个 线程 中 的 每 个 线程 发 送 10 个 请 求 ， 那 么 会 导致 分 段 错误 。 


我 们 在 函数 haswork() 、add() 和 puLLwork() 中 加 入 了 锁 保 护 。 这 些 保护 利用 互 斥 对 象 
lockObject 来 防止 多 个 线程 同时 访问 被 保护 的 代码 。 


x 

















c9/11/ThreadPool.h 


#include «string» 
#include «deque» 
#include «thread» 
#include «memory» 
*include «atomic» 
> #include «mutex» 





#include "Work.h" 


class ThreadPool { 
public: 


224 第 9 章 测试 驱动 开发 与 多 线程 





AAA 
bool hasWork() 1 
» std::lock guard«std::mutex» block(mutex ); 
return !workQueue .empty(); 
} 


void add(Work work) { 
» std::lock guard«std::mutex» block(mutex ); 
workQueue .push front(work); 


} 


Work pullWork() { 
» std::lock guard«std::mutex» block(mutex ); 


auto work - workQueue .back(); 
workQueue .pop back(); 
return work; 


std::atomic«bool-» done [false]; 

std::deque«Work» workQueue ; 

std::shared ptr«std::thread» workThread ; 
» std::mutex mutex ; 


}; 
测试 通过 了 。 将 线程 的 数目 增加 到 200， 情 况 看 起 来 依然 很 好 。 




















9.10 Æ ThreadPool 中 创建 多 个 线程 


就 这 样 结束 了 吗 ? 已 经 解决 了 所 有 的 并 发 性 漏洞 吗 ? 为 了 找 出 遗留 的 问题 , 一 种 分 析 方法 是 
想 想 任何 存在 的 缺口 。 缺口 是 指 ,我 们 基于 某 个 “事实 ”做 了 一 些 假 设 , 但 因为 其 他 失控 线程 的 
干扰 ， 这 个 “事实 ”并 不 成 立 。 


worker () 函数 看 起 来 是 唯一 可 能 包含 有 潜在 风险 代码 的 函数 。 在 worker() 函数 中 ， 我 们 轮 
询 可 用 的 工作 项 , 每 次 都 是 通过 循环 来 建立 、 释放 haswo rk() 中 的 一 个 锁 。 一 旦 有 可 用 的 工作 项 
循环 退出 , 控制 权 移交 给 puLLwo n ).execute() 。 设 想 一 下 , 如果 在 这 文 个 极为 短暂 的 时 间 段 里 ， 
其 他 的 线程 抓 取 了 可 用 工作 项 ， 那 么 会 发 生 什 么 情况 ? 


目前 ，ThreadPool 仅 仅 管 理 一 个 线程 ， 这 意味 着 worker( ) 函数 通过 串 行 的 方式 ， 一 个 接 一 个 
地 抓 取 并 执行 可 选 工作 项 ， 没 有 机 会 引发 并 发 性 的 问题 。 我 们 在 ThreadPool 中 加 入 对 线程 池 的 支 
持 ， 让 其 名 副 其 实 。 



























































c9/12/ThreadPoolTest.cpp 


TEST(AThreadPoolWithMultipleThreads, DispatchesWorkToMultipleThreads) 1 
unsigned int numberOfThreads(2); 
pool.start(numberOfThreads); 
Work work{[&] 1 
addThreadIfUnique(this thread::get id()); 
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incrementCountAndNotify(); 


}}; 
unsigned int NumberOfWorkItems{500}; 


for (unsigned int i(0); i < NumberOfWorkItems; i++) 
pool.add(work); 


waitForCountAndFailOnTimeout (NumberOfWorkItems); 
LONGS EQUAL(numberOfThreads, numberOfThreadsProcessed()); 
} 
测试 DispatchesWorkToMultipleThreads 展 示 了 客户 端 代 码 可 以 启动 指定 数量 的 线程 。 为 了 验 
证 ThreadPool 是 否 真 正在 不 同 线程 中 处 理 任 务 ， 先 要 更 新 回调 函数 : 如 果 ID 是 唯一 的 ， 那 么 就 增 
加 一 个 线程 。 断 言 比较 指定 的 线程 数目 和 被 执行 的 线程 数目 。 


( 遗憾 的 是 ， 这 个 测试 在 某 些 极端 情况 下 会 失败 ， 因 为 其 中 一 个 线程 会 处 理 所 有 的 工作 项 。 
如 何 去 除 潜在 的 影响 因素 就 留 给 读者 思考 了 。 ) 


修改 ThreadPool 以 支持 产生 指定 数量 的 线程 ， 仅 仅 需要 管理 线程 对 象 的 向 量 。 




















c9/12/ThreadPool.h 


#include «string» 
#include «deque» 
#incLude «thread» 
#include «memory» 
#include «atomic» 
#include <mutex> 
> #include <vector> 


#include "Work.h" 


class ThreadPool { 
public: 
CAR 
void stop() { 
done - true; 
for (auto& thread: threads ) thread.join(); 


Y 


) 


void start(unsigned int numberOfThreads-1) { 
for (unsigned int i(0u); i < numberOfThreads; i++) 
threads .push back(std::thread(&ThreadPool::worker, this)); 





YvYVYY 


} 
A 
private: 
pe Um 
std::atomic<bool> done {false}; 
std::deque<Work> workQueue ; 
std::shared ptr«std::thread» workThread ; 
std::mutex mutex ; 
» std::vector«std::thread» threads ; 


226 $93 测试 驱动 开发 与 多 线程 





测试 总 是 失败 。 考 虑 到 对 worker() 函数 的 怀疑 ， 我 们 增加 一 行 代 码 来 处 理 并 不 存在 的 工作 
项 〈 换 句 话 说， 其 他 线程 已 经 抓 取 了 该 工作 项 )。 





c9/12/ThreadPool.h 


Work pullWork() 1 
std::lock guard«std::mutex» block(mutex ); 


» if (workQueue .empty()) return Work(); 


auto work - workQueue .back(); 
workQueue .pop back(); 
return work; 


) 
测试 通过 了 ， 事 情 变 得 明朗 了 。 我 们 的 修复 直接 解决 了 并 发 性 问题 


对 并 发 性 问题 的 保守 反应 是 , 在 出 现 问题 的 地 方 增加 同步 机 制 。 最 终 可 能 会 导致 测试 运行 变 
慢 。 相 反 ， 测 试 驱动 能 帮助 我 们 确定 仅 在 需要 的 地 方 加 入 同步 机 但 






































c 
o 


9.11 ElžI| GeoServer 


我 们 已 经 设计 并 实现 了 ThreadPool， 现 在 开始 使 用 这 个 类 。 第 一 步 是 修改 usersInBox () , 增 
加 监听 或 者 回调 函数 的 参数 。 更 新 代码 , 将 User 对 象 通过 回调 函数 返回 给 客户 端 , 这 样 就 可 以 异 
步 地 集中 这 些 对 象 。 


在 测试 中 ， 监 听 程 序 仅仅 记录 那些 被 传 进 updated () 回调 函数 的 用 户 。 














c9/13/GeoServerTest.cpp 
TEST(AGeoServer UsersInBox, AnswersOnlyUsersWithinSpecifiedRange) 1 


» class GeoServerUserTrackinglistener: public GeoServerListener { 
» public: 

» void updated(const User& user) ( Users.push back(user); } 

» vector«User» Users; 

» ) trackingLlistener; 


server.updateLocation( 
bUser, Location([aUserLocation.go(Width / 2 - TenMeters, East)}); 


» server.usersInBox(aUser, Width, Height, &trackingListener); 


» CHECK EQUAL(vector«string» ( bUser }, UserNames(trackingLlistener.Users)); 
j 


c9/13/GeoServer.h 
class GeoServerlistener { 
public: 
virtual void updated(const User& user)-0; 


}; 
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class GeoServer { 
public: 
rs MENU 
std::vector«User» usersInBox( 
const std::string& user, double widthInMeters, double heightInMeters, 
GeoServerListener* listener-nullptr) const; 
d ura 
}; 


c9/13/GeoServer.cpp 


vector«User» GeoServer::usersInBox( 
const string& user, double widthInMeters, double heightInMeters, 
GeoServerListener* listener) const { 
auto location = locations .find(user)-»second; 
Area box ( location, widthInMeters, heightInMeters }; 


vector«User» users; 
for (auto& each: locations ) 
if (isDifferentUserInBounds(each, user, box)) ( 
users.push back(User[each.first, each.second])); 
» if (listener) 
» listener-»-updated(User(each.first, each.second]); 


H 


return users; 


H 

和 往常 一 样 , 我 们 寻求 逐步 改进 的 方式 ， 留 下 直接 返回 用 户 向 量 的 逻辑 。 这 可 以 在 浪费 大 量 
时 间 为 其 他 测试 编写 类 似 实现 之 前 ， 证 明 我 们 的 想法 。 
我 们 更 新 AnswersOnlyUsersWithinSpecifiedRange， 以 及 被 忽略 的 、 慢 速 的 测试 HandlesLarge- 
NumbersOfUsers。 将 GeoServerUserTrackingListener 类 的 通用 声明 作为 要 素 加 入 测试 集 。 我 们 删除 
了 支持 直接 返回 用 户 向 量 的 代码 。 最 后 , 我 们 修改 usersInBox( ) 以 假定 GeoServerListener 是 有 效 
的 指针 。 请 参考 code/c9/14 中 的 clean-up 部 分 。 


GeoServer 的 测试 AnswersUsersInSpecifiedRange 和 AnswersOnlyUsersWithinSpecifiedRange 
应 该 仍然 可 以 工作 。 但 如 果 使 用 ThreadPool ， 我 们 需要 在 测试 中 引入 等 待机 制 ， 就 像 在 
ThreadPoolTest 编 写 的 测试 一 样 。 相 反 ， 我 们 选择 引入 测试 替身 ， 将 ThreadPool 的 add( ) 函数 的 
实现 简化 为 单线 程 。 
























































c9/15/GeoServerTest.cpp 
TEST GROUP (AGeoServer UsersInBox) { 
GeoServer server; 
LI wan 
class SingleThreadedPool: public ThreadPool { 
public: 
virtual void add(Work work) override { work.execute(); } 
}; 
shared ptr<ThreadPool> pool; 
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void setup() override ( 
pool = make shared«SingleThreadedPool»(); 
server.useThreadPool(pool); 
Pf vus 


Li s 
h 
TEST(AGeoServer UsersInBox, AnswersUsersInSpecifiedRange) { 
pool-»start(0); 
server.updateLocation( 
bUser, Location([aUserLocation.go(Width / 2 - TenMeters, East)}); 
server.usersInBox(aUser, Width, Height, &trackingListener); 
CHECK EQUAL(vector«string» ( bUser ), UserNames(trackingListener.Users)); 


} 

我 们 将 ThreadPool 的 add () 函数 定义 为 虚 函 数 ， 以 允许 重 载 。 

测试 显 式 地 启动 线程 池 , 这 是 设计 上 的 考虑 客户 端 程序 负责 启动 线程 池 ( 这 个 重要 的 协 
议 将 在 你 编写 的 单独 测试 中 得 到 最 好 的 体现 )。 























c9/15/GeoServer.h 


class GeoServer { 

public: 
oes 
void useThreadPool(std::shared ptr«ThreadPool» pool); 
72 ME 

}; 


c9/15/GeoServer.cpp 
void GeoServer::usersInBox( 
const string& user, double widthInMeters, double heightInMeters, 
GeoServerListener* listener) const { 
auto location - locations .find(user)-»second; 
Area box ( location, widthInMeters, heightInMeters }; 
for (auto& each: locations ) { 
Work work([&] 1 
if (isDifferentUserInBounds(each, user, box)) 
listener-»updated(User(each.first, each.second)); 
3h 
» pool -»add(work); 


} 


> void GeoServer::useThreadPool(std::shared ptr«ThreadPool» pool) { 
» pool = pool; 
> } 


需要 编写 一 个 和 多 线程 池 交 互 的 测试 吗 ?” 为 了 测试 驱动 或 普通 单元 测试 , 不 需要 ! 我 们 已 经 
演示 了 ,ThreadPool 可 以 接收 工作 项 并 将 其 分 派 给 不 同 的 线程 ; GeoServer 逻 辑 可 以 判断 用 户 能 否 
在 矩形 区 域内 正确 地 工作 ; 也 演示 了 GeoServer 将 工作 项 发 送 到 ThreadPool 的 逻辑 。 
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任何 更 进一步 的 测试 都 应 该 是 其 他 类 型 的 , 仅 在 需要 时 才 编 写 。 因 为 之 前 使 用 多 线程 的 兴 
在 于 判断 我 们 是 否 能 从 usersInBox() 得 到 及 时 反馈 ， 以 及 异步 的 返回 位 置信 息 ， 所 以 我 们 确实 
需要 一 个 测试 。 

我 们 增 一 个 类 似 于 HandlesLargeNumbersOfUsers 的 新 测试 ， 但 在 单独 的 线程 中 触发 
usersInBox(), ， 并 在 主线 程 中 等 待 所 有 的 回调 。 我 们 想 将 这 个 测试 放 在 慢 测 试 集 中 。 

















c9/17/GeoServerTest.cpp 
TEST GROUP BASE(AGeoServer ScaleTests, GeoServerUsersInBoxTests) { 
class GeoServerCountingListener: public GeoServerLlistener { 
public: 
void updated(const User& user) override ( 
unique lock«std::mutex» lock(mutex ); 
Count; 
wasExecuted .notify all(); 


void waitForCountAndFailOnTimeout(unsigned int expectedCount, 
const milliseconds& time-milliseconds(10000)) { 
unique lock«mutex» lock(mutex ); 
CHECK TRUE(wasExecuted .wait for(lock, time, [&] 
( return expectedCount == Count; ))); 
J 
condition variable wasExecuted ; 
unsigned int Count(0); 
mutex mutex ; 
GeoServerCountingListener countingListener; 
shared ptr«thread» t; 


void setup() override ( 
pool = make shared«ThreadPool»(); 
GeoServerUsersInBoxTests::setup(); 


} 


void teardown() override { 
t-»join(); 
} 
h 


TEST(AGeoServer ScaleTests, HandlesLargeNumbersOfUsers) { 
pool-»start(4); 
const unsigned int lots(5000); 
addUsersAt(lots, Location(aUserLocation.go(TenMeters, West))); 


t = make shared«thread»( 
[S] { server.usersInBox(aUser, Width, Height, &countingListener); }); 


countingListener.waitForCountAndFailOnTimeout(lots); 
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(考虑 到 之 前 为 usersInBox() 编 写 的 测试 中 有 很 多 类 似 的 设置 过 程 , 你 在 这 里 看 到 的 代码 是 
一 个 经 过 大 量 重 构 后 的 代表 。 对 于 wait/motify 概 念 的 实现 和 使 用 ，GeoServerCountingListener 和 
ThreadPoolTest 中 仍然 有 大 量 重复 的 代码 。 我 们 将 重 构 一 个 任何 线程 测试 都 能 使 用 的 构造 体 。 ) 























9.12 ”结束 语 


写 多 线程 代码 或 许 是 软件 开发 领域 中 最 复杂 的 任务 。 支 持 并 发 性 使 其 变 得 更 难 , 好 在 很 少 
需要 经 常 编写 这 样 的 代码 。TDD 模 式 可 以 让 你 的 多 线程 编程 沿 着 科学 方法 论 的 方向 前 行 , 远离 神 
秘 主义 。 不 同 于 希望 你 深入 理解 并 发 执行 的 机 理 , 或 者 在 任何 出 现 问题 的 地 方 放置 锁 和 同步 机 制 ， 
我 们 希望 你 可 以 将 TDD 模 式 作为 一 个 工具 ， 用 来 验证 或 否定 有 关 并 发 性 问题 的 假设 。 

我 们 已 经 覆盖 了 所 有 关于 TDD 的 主要 知识 点 。 你 已 经 学 会 了 如 何 用 测试 的 方式 驱动 开发 ; 如 
何 进 行 必要 的 测试 ， 如何 解决 具体 的 多 线程 问题 。 下 一 步 你 将 学 习 有 关 TDD 模 式 的 其 他 知识 点 。 
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测试 驱动 开发 的 其 他 概 依 和 


讨论 








10.1 ”开场白 


并 不 是 所 有 事情 都 能 放 进 小 巧 、 整 洁 的 框架 中 。 在 前 面 的 章节 中 , 你 学 习 了 TDD 的 核心 理念 : 
TDD 的 周期 TDD 的 基本 概念 、 构 建 的 指导 方针 、 创 建 和 使 用 测试 蔡 身 的 方式 、 设 计 要 素 、 编 写 
质量 测试 的 方式 以 及 如 何 处 理 遗 留 代码 的 挑战 。 你 还 学 习 了 如 何 通 过 测试 驱动 的 方式 编写 多 线程 
代码 。 从 编写 代码 的 角度 来 说 ， 差 不 多 就 是 这 些 内 容 …… 但 还 有 其 他 一 些 零碎 的 事情 。 


尔 将 在 本 章 中 学 习 以 下 并 未 在 其 他 音节 展开 讨论 的 内 容 。 


口 TDD 和 性 能 : 消除 对 性 能 的 担忧 可 以 让 你 在 练习 测试 驱动 期 间 睡 个 好 觉 。 
口 集成 测试 和 验收 测试 : 还 需要 什么 类 型 的 测试 ?它们 和 单元 测试 的 区 别 是 什么 ? 
口 变换 优先 级 假设 (Transformation Priority Premise, TPP ): 这 是 决定 你 如 何 编写 下 一 个 测 






















































































试 的 正式 方法 。 
口 三 角 法 : 这 是 驱动 编写 通用 代码 的 一 个 技巧 (虽然 其 本 身 就 可 以 作为 一 个 主题 但 我 们 


仍 将 其 包含 在 TPP 章 节 中 )。 
口 首先 编写 断言 部 分 : 编写 测试 的 推荐 方法 。 





10.2 ”测试 驱动 开发 与 性 能 


在 任何 系统 中 , 合格 的 性 能 是 一 项 非常 重要 的 需求 。 考 虑 到 性 能 方面 的 潜能 , 很 多 人 可 能 倾 
向 于 使 用 C+ 编程。 本 书 的 很 多 地 方 有 意 规 避 了 性 能 方面 的 担忧 ， 并 让 你 们 参考 这 一 节 。 这 并 不 
意味 着 性 能 不 重要 ， 相 反 ， 它 很 重要 。 

归 人 到 性 能 测试 集中 的 绝 大 多 数 内 容 既 不 是 TDD, 也 不 是 单元 测试 。 本 节 展 示 了 以 测试 为 中 
心 的 策略 可 以 优化 性 能 ; 讨论 了 单元 级 测试 如 何 帮助 实现 这 个 策略 ， 以 及 设计 与 性 能 的 关联 ; 并 
强调 在 尝试 解决 性 能 问题 之 前 ， 应 该 要 先 找寻 最 优 设 计 方 案 。 
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一 般 来 说 ， 性 能 方面 的 考虑 不 是 功能 上 的 需求 。 在 最 多 有 10 000 个 用 户 同时 在 线 的 负载 下 ， 
系统 需要 在 半 秒 内 对 用 户 交互 作出 反应 。 系 统 需要 整 夜 运行 一 批 处 理 脚 本 ， 等 等 。 这 些 都 是 集成 
层面 的 关注 点 ( 详 见 10.3 节 )， 需 要 一 个 集成 且 部 署 好 的 系统 。 你 无 法 用 验证 独立 多 辑 的 单元 测 
试 来 测试 这 些 关注 点 。 

从 (单元 级 ) 测试 驱动 的 角度 来 看 ， 你 几乎 不 可 能 基于 已 有 的 知识 说 出 “这 个 函数 必须 在 
微 秘 或 更 短 的 时 间 内 作出 反应 ”这 样 的 话 。 在 决定 需求 之 前 ， 你 需要 了 解 函数 的 性 能 特征 是 如 何 
与 终端 行为 的 需求 联系 起 来 的 。 即 使 能 得 到 一 个 具体 而 微观 的 性 能 需求 ， 你 将 会 发 现 : 由 于 不 同 
机 器 间 的 不 同 特性 ， 你 很 难 找到 一 个 一 致 的 、 支 持 所 有 平台 ( 开发 、 集 成 、 产 品 ， 等 等 ) 的 测试 
手段 












































10.2.1 性 能 优化 测试 的 策略 

以 下 是 性 能 优化 的 通用 策略 。 

口 依据 测试 框架 构建 并 运行 驱动 代码 ， 由 此 得 到 系统 性 能 的 基准 值 。 

口 确保 测试 能 正确 展示 特性 的 功能 一 一 优化 系统 时 很 容易 破坏 系统 的 功能 性 。 

O 将 驱动 代码 转变 为 可 以 指定 当前 性 能 基准 的 测试 。 如 果菜 个 尝试 的 优化 导致 性 能 下 降 ， 

那么 这 个 基准 测试 将 会 失败 。 

a 新 增 一 个 目标 测试 以 运行 相同 的 功能 ， 只 有 性 能 达到 一 定 要 求 时 测试 才 会 通过 。( 这 可 能 

是 基准 测试 中 的 第 二 个 断言 。) 

OQ 确定 性 能 瓶颈 。 

a 尝试 优化 与 性 能 瓶颈 相关 的 代码 。 你 应 该 有 能 力 判断 是 否 存在 可 能 的 算法 优化 (比如 ， 
将 复杂 度 为 On) 的 算法 替换 为 On log n) ) 如 果 是 这 样 的 话 , 那么 就 从 这 里 开始 吧 。 否则 ， 
就 从 高 质量 设计 和 良好 表达 性 的 角度 入 手 。 通常 而 言 , 未 能 以 最 佳 方式 利用 C++ 可 能 是 潜 
在 的 因素 ( 比如， 如 何 传递 参数 、 使 用 参数 、 构 造 新 的 对 象 ， 被 误导 尝试 去 做 的 比 STL 
容器 或 Boost 更 好 )。 

口 确保 单元 测试 和 验收 测试 依然 可 以 通过 。 

a 运行 基准 测试 ; 如 果 测 试 失败 ( 换 名 话说， 如果 新 的 性 能 更 精 ), 那么 就 放弃 当前 的 改动 ， 

口 运行 目标 测试 ， 如 果 测 试 通 过 ， 那 就 发 布 吧 ! 

口 如 果 目 标 测试 失败 ， 可 以 尝试 通过 以 下 方式 解决 性 能 问题 ， 找 出 第 二 大 的 性 能 瓶颈 ， 尝 
试 提升 性 能 ， 以 此 类 推 。 然而， 你 的 优化 尝试 可 能 并 不 合适 。 更 好 的 方法 是 记录 相对 的 
性 能 提升 ， 并 为 代码 的 改动 做 上 标记 。 继 续 找 寻 另 一 个 优化 方案 ,重复 这 一 过 程 ， 检 查 
是 否 达 到 了 性 能 目标 。 

如 果 你 是 通过 增 量 合并 的 方式 实现 优化 ， 那 么 要 确保 及 时 更 新 基准 测试 的 条 件 。 

以 下 是 尝试 做 优化 时 的 一 些 非常 重要 的 概念 。 
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口 在 与 生产 目标 具有 同样 特性 的 机 需 上 和 运行 性 能 测试 。 在 其 他 机 需 上 的 测试 结果 可 能 不 能 
准确 地 反映 出 优化 对 产品 的 影响 ， 因 此 ， 进 行 这 些 优化 可 能 会 浪费 时 间 ， 甚 至 导致 性 能 
变 得 更 糟糕 。 

O 不 做 任何 假设 。 对 需要 优化 的 地 方 的 直觉 往往 是 错误 的 。 永 远 要 比 对 优化 前 后 的 测试 数 

据 。 

a 首先 要 正确 地 设计 ， 且 仅 在 此 基础 上 采取 优化 措施 。 除 非 万 不 得 已 ， 否 则 不 要 为 了 引入 
某 些 优 化 而 牺牲 系统 的 可 维护 性 和 可 读 性 。 记 住 ， 首 先 要 正确 地 设计 ! 





















































10.2.2 ”相关 单元 级 性 能 测试 

单元 级 性 能 测试 能 帮助 你 沿 着 TDD 的 方向 前 行 , 但 无 法 利用 它们 来 判断 是 否 已 经 达到 性 能 
标 要 求 。 相 反 ， 把 它们 视 为 工具 将 帮助 你 探究 这 些 难 题 。 

你 将 在 本 节 中 学 习 获 取 函 数 平均 运行 时 间 的 一 个 简单 技巧 。 只 有 这 些 优 化 都 针对 同一 个 函数 
时 ， 执 行 时 间 才 有 意义 。 


在 一 些 罕见 的 情况 下 ， 你 可 以 预先 定义 单元 级 的 需求 ， 然 后 利用 相关 的 单元 级 性 能 测试 
( Relative Unit-Level Performance Tests ， 我 称 它们 为 RUPT ) 来 测试 驱动 这 个 需求 。 和 否则， 你 将 置 
身 于 开发 之 后 再 测试 的 领域 。 


以 下 是 关于 RUPT 的 一 些 步 又 。 


(1) 创建 一 个 循环 ， 多 次 (如 50 000 次 ) 反复 执行 需要 对 其 进行 时 间 测 量 的 特性 。 应 该 消除 由 
启动 开销 或 时 钟 周 期 带 来 的 任何 差异 。 还 要 确认 编译 器 没有 优化 这 些 需 要 计时 的 特性 。 

(2) 在 循环 前 获取 当前 的 时 间 惟 ， 并 将 其 存储 在 变量 start 中 。 

(3) 在 执行 行为 的 代码 后 获取 当前 的 时 间 戳 ， 并 将 其 存储 在 变量 stop 中 。 相 对 测量 值 就 是 
stop 和 start 之 间 的 时 间 差 。 

(4) 运行 RUPT 并 记录 时 间 差 。 调 整 循环 次 数 以 寻找 几 秒 的 时 间 差 。 

(5) 以 数量 级 的 方式 增加 循环 次 数 。 运 行 测试 并 确保 时 间 差 也 是 以 类 似 的 方式 增长 。 如 果 不 
是 这 样 ， 那 么 就 说 明 RUPT 不 能 准确 地 表征 你 的 优化 尝试 。 你 需要 找到 原因 并 修复 。 

(6) 继续 多 次 运行 RUPT。 如 果 时 间 差 的 变化 非常 大 ， 说 明 这 不 是 一 个 有 效 的 RUPT。 找 到 原 
因 并 修复 ， 和 否则 ， 记 录 平 均 时 间 差 。 

(7) 尝试 优化 代码 。 

(8) 多 次 运行 RUPT 并 记录 平均 时 间 差 。 

(9) 如 果 能 获得 较 大 的 性 能 改善 ， 则 继续 运行 性 能 测试 ， 并 调整 基准 目标 。 否 则 ， 抛 弃 这 些 
改动 。 

将 相关 的 单元 级 性 能 测试 作为 一 种 探测 手段 , 你 可 以 决定 抛弃 一 段 犹 如 烂泥 般 毫 无 意义 的 代 
码 ， 或 者 进一步 利用 它 。 在 任何 情况 下 ， 这 些 代码 都 不 应 该 出 现在 你 的 产品 级 单元 测试 集中 。 
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10.2.3 ”党 试 优化 GeoServer 代码 
现在 我 们 来 学 习 一 个 创建 RUPT 的 简短 例子 : 


c9/24/GeoServerTest.cpp 
TEST(AGeoServer Performance, LocationOf) { 
const unsigned int lots(50000); 
addUsersAt(lots, Location(aUserLocation.go(TenMeters, West))); 


TestTimer t; 
for (unsigned int i{0}; i < lots; i++) 
server.locationOf(userName(i)); 


) 











TestTimer 是 一 个 简单 的 类 ,一 旦 超出 范围 , 它 将 在 控制 台 打 印 出 性 能 测量 结果 。 关 于 TestTimer 
的 具体 实现 ， 请 参见 10.2.4 节 。 

















以 下 是 我 们 测试 的 代码 。Location0f() 和 isTracking() 都 调用 了 find， 这 是 一 个 不 可 接受 
的 性 能 下 降 吗 ? 


c9/24/GeoServer.cpp 


bool GeoServer::isTracking(const string& user) const ( 
return find(user) !- locations .end(); 


} 


Location GeoServer::locationOf(const string& user) const { 
if (!isTracking(user)) return Location(); // T0D0 性 能 开销 ? 


return find(user)-»second; 


} 


将 循环 次 数 设 为 50 000 并 多 次 运行 测试 。 我 们 记录 下 平均 运行 时 间 〈 在 我 的 机 器 上 约 为 50 
毫秒 )。 

将 循环 次 数 扩 大 为 500 000 并 多 次 运行 测试 ， 然 后 记录 平均 运行 时 间 。 我 们 希望 看 到 平均 运 
行 时 间 大 致 成 比例 地 增长 ， 事 实 也 确实 如 此 。 平 均 运行 时 间 是 574 毫 秒 。 如 果 没 有 增长 ， 我 们 需 
要 找到 一 种 方式 阻止 C++ 编译 器 来 优化 循环 中 的 某 些 操作 。( 在 gcc 中 可 以 增加 一 条 汇编 指令 : 


asm(""); )。 






































用 修改 代码 消除 对 find () 函数 的 第 二 个 调用 。 


c9/25/GeoServer.cpp 

Location GeoServer::locationOf(const string& user) const { 
// 优化 后 
auto it = find(user); 


if (it == locations .end()) return Location(); 
return it-»second; 
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没 错 ， 添 加 注释 是 明智 之 举 (虽然 你 可 能 要 提供 更 多 解释 )。 熟 悉 TDD 的 优秀 程序 员 总 会 不 
断 地 尝试 提高 代码 的 质量 。 如 果 没 有 注释 来 描述 你 为 什么 如 此 编写 代码 , 那么 一 位 优秀 的 程序 
很 可 能 会 清除 掉 这 段 关 于 性 能 优化 的 代码 。 而 且 ， 因 为 不 会 频繁 地 运行 和 性 能 相关 的 验收 测试 ， 
所 以 当 你 发 现 目标 性 能 测试 失败 时 ， 可 能 很 难 甄别 出 这 是 由 哪些 代码 改动 导致 的 。 

重新 运行 性 能 测试 并 记录 下 新 的 平均 运行 时 间 一 一 488 毫 秒 ， 这 上 比 之 前 快 了 86 毫 秒 。 数 字 显 
示 ， 宛 余地 调用 find ( ) 函数 会 导致 约 18% 的 性 能 下 降 。 这 听 起 来 好 像 很 多 , 但 记 住 ,我 们 运行 了 
500 000 个 需求 ， 对 于 每 一 个 需求 ， 差 别 是 0.17 微 秒 。 

这 些 事实 从 性 能 角度 上 来 说 是 关于 行为 中 的 变化 ,虽然 它们 仅仅 提供 了 相对 的 、 孤 立 的 价值 ， 
但 它们 并 不 是 猜测 。 我 们 知道 ， 代 码 优化 的 尝试 是 成 功 的 ， 因 为 它 提高 了 代码 片段 的 执行 效率 。 
这 比 我 们 之 前 了 解 得 更 多 ， 也 使 很 多 开发 者 在 尝试 优化 一 个 方案 之 后 了 解 得 更 多 。 

现在 的 问题 是 , 它 是 有 用 的 吗 ? 基于 这 一 点 , 我们 将 运行 基准 性 能 测试 和 目标 性 能 测试 ,并 
判断 这 个 优化 是 否 是 必需 的 。 如 果 该 优化 不 是 必需 的 ， 只 是 让 代码 变 得 更 复杂 ,那么 就 删除 这 个 
优化 。 

保留 该 优化 的 代价 看 起 来 很 小 。Llocation0f() 函数 仅仅 将 一 行 代码 变 成 了 三 行 代码 。 很 多 
有 用 的 优化 往往 会 增加 很 多 相当 难以 解释 和 维护 的 代码 。 

因为 有 清晰 的 设计 ， 所 以 另 一 个 潜在 的 优化 应 该 很 容易 实现 。 在 同时 跟踪 成 千 上 万 位 用 户 
的 GeoServer 中 ， 增 加 用 户 缓存 是 十 分 合理 的 方案 。 在 任何 给 定 的 时 间 段 内 ， 服 务 器 有 可 能 会 被 
询问 一 小 部 分 用 户 的 位 置信 息 ， 并 且 很 多 需求 将 会 和 之 前 的 需求 重复 。 目 前 都 是 通过 访问 子 函 
数 find() 来 查找 Location 地图。 我们 可 以 修改 find() 函数 中 的 代码 来 使 用 缓存 。 客 户 端 代 码 
依然 保留 当前 的 设计 。 相 反 ， 在 一 个 总 是 直接 访问 成 员 变 量 的 类 中 引入 缓存 机 制 将 是 一 个 持久 
的 过 程 。 

清晰 的 设计 从 两 个 方面 对 性 能 优化 有 所 帮助 。 首 先 ， 当 拥有 简洁 的 函数 定义 时 ， 用 分 析 工 具 
更 容易 查 明 性 能 问题 所 在 。 其 次 , 简洁 的 类 和 函数 可 以 帮助 你 思考 出 富有 创意 的 优化 方法 。 一 旦 
找 出 问题 所 在 ， 改 动 代码 也 会 变 得 更 轻松 。 相 反 ， 想 像 一 下 ， 在 一 个 有 500 行 代码 的 函数 中 隐藏 
了 一 个 性 能 瓶颈 。 你 将 花费 更 多 时 间 找 出 问题 并 修复 。( 而 且 , 一 个 有 500 行 代码 的 函数 几乎 不 可 
能 拥有 充分 的 测试 来 让 你 有 信心 做 一 些 适 当 的 性 能 优化 。) 





















































































































































10.2.4 TestTimer 类 

TestTimer 类 是 一 个 草草 写 就 的 简单 工具 , 可 在 测试 中 任何 需要 的 地 方 使 用 。 在 函数 结束 运行 
之 前 , 它 将 打印 出 函数 运行 时 间 ， 以 及 传递 给 构造 函数 的 解释 性 文本 。 如 果 使 用 无 参数 的 构造 函 
数 ， 那 么 解释 性 文本 就 是 当前 测试 的 名 称 。 




















c9/25/TestTimer.h 
#ifndef TestTimer h 
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^u 
HE 


#define TestTimer h 


#incLude «string» 
Xinclude «chrono» 


struct TestTimer { 
TestTimer(); 
TestTimer(const std::string& text); 
virtual -TestTimer() 


std::chrono::time point«std::chrono::system clock» Start; 
std::chrono::time point«std::chrono::system clock» Stop; 
std::chrono::microseconds Elapsed; 
std::string Text; 

H 


#endif 


c9/25/TestTimer.cpp 


Zinclude "TestTimer.h" 
#include "CppUTest/Utest.h" 
#include <iostream> 


using namespace std; 


TestTimer::TestTimer() 
: TestTimer(UtestShell::getCurrent()-»getName().asCharString()) { 
} 


TestTimer::TestTimer(const string& text) 
: Start(chrono::system clock::now()] 
, lext(text) {} 
TestTimer::-TestTimer() 1 
Stop = chrono::system clock::now(); 
Elapsed = chrono::duration cast«chrono::microseconds»(Stop - Start); 
cout «« endl «« 
Text << " elapsed time = " << Elapsed.count() * 0.001 << "ms" << endl; 


) 


你 可 以 并 且 应 该 增强 Timer 类 以 满足 需求 。 你 可 能 想 将 它 变 成 线程 安全 的 ( 它 并 不 是 ) 你 可 
高 向 于 使 用 一 些 不 同 的 、 但 与 平台 相关 的 时 间 度 量 API， 或 者 你 的 系统 可 以 提供 一 个 C++11 的 











高 分 辨 率 时 钟 的 单独 实现 。 你 或 许 有 能 力 使 用 更 小 的 时 间 度 量 单位 〈 纳 秒 ! ) 或 者 更 大 的 时 间 度 
量 单位 。 又 或 者 你 可 以 选择 直接 将 这 几 行 代码 插入 到 测试 中 ， 虽 然 这 看 起 来 是 无 谓 的 举动 。 

















5 











10.2.5 ”性 能 和 小 函数 


C++ 程序 员 常 常 担心 调用 成 员 函 数 的 性 能 开销 。 因 此 ， 很 多 程序 员 不 愿意 接受 创建 小 的 函数 





和 类 的 观点 。“ 我 不 想 将 代码 抽取 出 来 放 在 男 一 个 单独 的 函数 中 ， 这 样 做 可 能 会 引入 性 能 问题 。” 
但 现今 的 编译 需 是 非常 聪明 的 ， 其 在 很 多 方面 的 优化 比 手工 的 更 好 。 
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与 其 基于 那些 无 移 之 谈 而 抵制 使 用 小 函数 ， 还 不 如 看 看 具体 的 数据 。 


c9/26/GeoServer.cpp 
Location GeoServer::locationOf(const string& user) const { 
// 优化 后 
auto it = locations .find(user); 
if (it == locations .end()) return Location{}; 
return it-»second; 
} 

















在 将 find() 变 成 内 联 函 数 之 前 ， 平 均 运 行 时 间 是 488 毫 秒 。 内 联 之 后 的 平均 运行 时 间 是 476 
毫秒 。 从 统计 的 角度 来 看 ，500 000 次 运行 导致 的 差异 几乎 微不足道 。 

是 不 是 find( ) 函数 从 一 开始 就 被 编译 絮 变 成 内 联 函 数 了 呢 ?” 如 果 强 制 让 gcc 不 去 内 联 该 函 
数 ， 那 么 在 运行 时 间 上 并 无 实质 的 区 别 (A742E Rb )。 














c9/27/GeoServer.h 
std::unordered mapsstd::string, Location»::const iterator 
find(const std::string& user) 
» const 
. attribute ((noinline)); 


小 函数 的 另 一 个 有 趣 方面 是 ，C++ 编 译 需 很 有 可 能 在 一 开始 就 将 其 变 成 内 联 函 数 。 对 较 大 的 
函数 来 说 ， 这 实际 上 减少 了 编译 需 优 化 代码 的 机 会 

事实 上 ， 个 将 部 分 代码 抽取 出 来 并 放 进 较 小 的 函 cni 而 且 它 实际 上 并 不 
能 提高 应 用 程序 的 性 能 。 性 能 方面 的 专家 早 就 知道 


而 且 ， 不 要 言 目 地 相信 我 ， 我 可 能 是 个 姿 姿 妈妈 的 人 。 要 相信 你 自己 的 测量 结 





















































10.26 ”推荐 


性 能 优化 方面 的 很 多 想法 都 是 基于 民间 传说 和 其 他 人 的 经 验 。 不 要 相信 其 他 人 的 经 验 。 其 次 
既然 几乎 每 个 人 都 在 说 同一 件 事情 , 那么 听 听 大 家 的 一 致 说 法 是 很 有 价值 的 。 我 会 将 我 的 一 些 经 
验 加 入 其 中 。 





我 的 优化 经 验 

作为 程序 员 ， 我 参与 了 许多 与 优化 相关 的 工作 。 作 为 顾问 ， 我 和 很 多 程序 员 一 起 
合作 过 ， 而 优化 就 是 他 们 的 主要 任务 ( 其 中 一 个 平台 需要 每 秒 处 理 20 000 多 项 交易 )。 
在 这 两 个 领域 中 ， 我 经 历 并 见证 过 源 于 严格 方法 的 成 功 案例 ， 这 些 方法 和 之 前 的 推荐 





不 谋 而 合 。 我 也 目睹 过 一 个 令 人 扼腕 的 失败 案例 : 一 个 公司 花费 高 薪 聘 请 了 一 些 咨询 
专家 ,竭力 尝 试 应 对 一 个 实时 大 规模 应 用 所 带 来 的 挑战 ， 却 采用 了 “ 东 试 一 下 ， 西 试 
一 下 ”的 方法 。 


以 下 是 应 对 性 能 挑战 的 一 些 关 键 因 素 。 
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口 一 个 稳 国 的 架构 : 架构 一 词 意味 着 ， 一 旦 就 绪 就 不 要 轻易 改变 方方面面 的 布局 。 
例如 ， 各 个 模块 之 间 的 流程 关系 图 (分布 在 服务 器 端 和 客户 端 )， 架 构 如 何在 不 
修改 代码 的 基础 上 支持 不 同 配置 的 硬件 ( 换 和 名 话说， 通过 扩充 硬件 的 方式 ) ? 

口 一 个 拥有 简洁 代码 、 稳 国 且 灵活 的 设计 ， 以 及 在 需要 大 规模 修改 代码 时 能 提供 

灵活 性 的 测试 。 

口 一 组 从 一 开始 就 定义 好 的 、 关 于 未 来 性 能 期 望 的 性 能 目标 测试 。 如 果 你 希望 在 
前 期 将 应 用 程序 发 布 给 十 几 位 用 户 ， 而 最 终 用 户 数量 达到 一 百 位 ， 你 需要 立即 
知道 在 新 的 代码 中 是 否 因 用 户 数目 的 变化 而 存在 风险 。 





就 代码 级 优化 的 趋势 而 言 ， 我 看 到 一 些 迹象 ， 听 到 一 些 性 能 专家 反驳 “ 先 设 计 ， 然 
后 仅 在 需要 时 才 优 化 ”的 观点 。 

我 看 到 过 许多 执迷不悟 的 优化 尝试 。 有 些 情况 是 基于 被 误导 或 明显 错误 的 民间 传说 
(有 时 甚至 是 另 一 种 语言 )。 在 另 一 些 情况 中 ,优化 建议 曾经 是 正确 的 ,但 后 来 被 改进 后 
的 编译 器 和 运行 时 间 所 淘汰 。 

有 些 代码 级 的 优化 的 确 可 以 归 到 自由 的 范畴 。 比 如 ， 在 C++ 中 ， 用 引用 传递 比 用 值 
传递 的 效率 更 高 ， 且 不 影响 代码 的 表达 性 。 如 果 这 些 优 化 没有 降低 可 读 性 或 易 维护 性 ， 
那 就 去 看 看 吧 。 否 则 ， 就 留待 以 后 (很久 以 后 ) 再 研究 吧 。 


10.3 ”单元 测试 、 集 成 测试 和 验收 测试 


TDD 模 式 是 帮助 程序 员 增 量 设计 和 开发 代码 的 一 种 实践 。 你 已 经 学 会 了 如 何 使 用 它 , 并 通过 
编写 单元 测试 来 验证 C++ 中 的 一 些 逻 辑 ， 这 也 允许 你 不 断 修正 代码 设计 。 
在 本 书 中 ,单元 指 的 是 一 个 小 而 独立 ， 且 能 影响 某 些 系统 行为 的 逻辑 片段 。 定 义 中 的 独立 表 
明 , 你 可 以 单独 运行 这 个 逻辑 单元 。 这 要 求 去 除 该 逻辑 单元 对 其 他 模块 ( 如 服务 调用 、 应 用 程序 
接口 、 数 据 库 、 文 件 系统 ， 等 等 ) 的 依赖 关系 。( 从 技术 的 角度 来 看 ， 独 立 的 代码 应 该 和 其 他 代 
码 没有 任何 耘 合 ; 但 实际 的 方法 表明 ， 并 不 总 是 需要 所 有 的 代码 逻辑 都 是 完全 独立 的 。) 就 像 本 
书 其 他 地 方 重点 说 明 的 一 样 (如 4.3 节 )， 单 元 测试 对 于 驱动 开发 测试 的 重要 意义 在 于 ， 它 能 快速 
修改 和 调整 。 


不 难 发 现 ,仅仅 靠 单元 测试 还 是 不 够 的 。 因 为 它们 仅仅 验证 了 那些 细小 的 、 相 互 独立 的 代码 
片段 ,无 法 验证 端 对 端 或 已 部 署 方案 的 正确 性 。 除 了 单元 测试 ,系统 还 需要 其 他 测试 ， 这 些 测试 
能 让 你 对 即将 发 布 的 产品 的 质量 抱 有 很 高 的 信心 ， 其 中 包含 了 系统 测试 、 客 户 测试 、 验 收 测试 、 
负载 测试 、 性 能 测试 、 可 用 性 测试 、 功 能 测试 以 及 可 扩展 性 测试 (有些 测试 大 同 小 异 )。 因 为 所 
有 这 些 测试 都 是 基于 集成 的 软件 产品 进行 验证 的 ， 所 以 都 是 集成 测试 。 

负责 定义 集成 测试 的 人 往往 取决 于 不 同 的 情况 。 典 型 情况 下 无 外 乎 三 种 人 : 测试 员 、 程 序 员 
和 客户 。 
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根据 敏捷 开发 社区 , 客户 测试 是 指 那些 用 以 验证 软件 是 否 满足 商业 需求 的 测试 。 在 一 个 敏捷 
过 程 中 , 测试 是 在 程序 开发 之 前 就 定义 好 的 ,这 样 就 可 以 给 研发 团队 提供 各 种 各 样 的 规范 , 这 和 
TDD 模 式 很 类 似 。 敏捷 开发 的 支持 者 往往 将 客户 测试 预先 定义 为 验收 测试 。 如 果 研发 团队 开发 的 
软件 能 够 通过 所 有 的 测试 ， 那 么 客户 就 会 同意 接受 这 款 软件 。 





























10.3.1 测试 驱动 开发 如 何 与 验收 测试 建立 联系 


通过 预先 定义 验收 测试 的 方式 来 驱动 系统 的 开发 流程 , 以 及 通过 使 用 TDD 来 驱动 一 些 逻 辑 模 
块 的 开发 流程 , 这 二 者 是 非常 类 似 的 。 实际 上 , 采用 验收 测试 的 团队 称 这 种 流程 为 验收 测试 驱动 
开发 ( Acceptance Test-Driven Development, ATDD )。 


你 可 以 看 看 验收 测试 是 如 何 融 人 开发 流程 的 、 使 用 了 哪些 工具 、 这 些 测试 应 该 是 什么 样 的 ， 
等 等 。 如 果 你 理解 了 TDD, 那么 你 已 经 具备 了 绝 大 部 分 的 知识 来 理解 什么 是 ATDD， 以 及 如 何在 
实际 中 成 功 地 应 用 它 。 


TDD 与 ATDD 的 重要 区 别 在 于 ,， 谁 定义 了 这 些 测试 以 及 谁 会 使 用 这 些 测试 。 对 TDD 而 言 ， 程 
序 员 负责 用 编程 语言 定义 单元 测试 。 因 此， 即将 阅读 或 者 使 用 这 些 测试 的 人 毫 无 疑问 就 是 程序 员 
本 身 (但 这 并 不 意味 着 你 可 以 毫 不 关心 他 们 代码 的 可 阅读 性 )。 

对 ATDD 而 言 ， 客 户 ( 可 能 也 包含 了 产品 负责 人 或 商业 分 析 员 ) 负责 根据 商业 需求 定义 验收 
测试 。 他 们 绝 不 是 凭空 捏造 。 创建 健壮 的 验收 测试 , 需要 团队 包括 测试 员 和 程序 员 在 内 的 其 他 人 
员 的 意见 与 信息 。 每 个 人 都 会 使 用 基于 ATDD 的 测试 。 

有 一 些 专门 论述 ATDD 的 书籍 ， 如 《实例 化 需求 : 团队 如 何 交 付 正确 的 软件 》《 验 收 测试 驱 
动 开 发 : ATDD 实 例 详解 >》 通过 搜索 关键 字 ， 你 也 可 以 找到 一 些 相 关 的 其 他 信息 。 





















































10.3.2 程序 员 定 义 的 集成 测试 


作为 程序 员 ， 你 总 是 可 以 选择 编写 面向 程序 员 的 集成 测试 。 一 些 精 挑 细 选 的 集成 测试 是 非 
常 有 价值 的 ， 而 且 公司 可 能 也 需要 。 可 以 直接 测试 数据 访问 层 以 获得 更 多 的 即时 信息 以 及 关于 
代码 和 数据 储存 定义 之 间 差 异性 的 故障 信息 ， 也 可 以 使 用 一 组 冒 烟 测 试 来 快速 判断 部 署 的 配置 
是 否 正确 。 


然而 ,集成 测试 很 难 维护 。 因 为 集成 测试 应 对 的 软件 被 部 署 在 定制 的 环境 中 ,需要 和 外 部 服 
务 和 数据 存储 的 野蛮 世界 进行 交互 , 所 以 它们 是 脆弱 的 。 始 终 保 持 测 试 最 新 且 可 以 在 所 有 的 部 署 
环境 中 运行 是 巨大 的 挑战 。 

最 好 只 编写 所 需要 的 集成 测试 ， 而 不 是 越 多 越 好 。 作 为 一 个 策略 ,要 么 尝试 将 集成 测试 定位 
为 客户 测试 ( 你 的 客户 愿意 采纳 )， 要 么 移 除 它 的 依赖 关系 ， 并 将 其 作为 展示 代码 级 逻辑 的 单元 
测试 。 
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如 果 你 的 团队 已 经 通过 单元 测试 工具 ( 如 Google Test ) 创 建 了 一 些 测试 ， 你 可 能 发 现 很 多 表 
面 上 的 单元 测试 实际 上 是 集成 测试 。 这 些 测 试 尝试 验证 部 分 代码 逻辑 , 但 由 于 和 其 他 逻辑 模块 之 
间 的 耦合 ， 它 们 被 纳入 慢 而 脆弱 的 集成 测试 中 。 

抽出 时 间 分 类 集成 测试 。 对 每 个 测试 采取 以 下 四 个 动作 中 的 一 个 : 


口 清理 集成 测试 ， 并 将 其 作为 验收 测试 出 售 ; 

口 通过 移 除 对 其 他 逻辑 模块 的 依赖 ， 将 其 转变 为 一 个 快速 的 单元 测试 ; 
口 将 其 作为 勉强 保留 的 集成 测试 ; 

口 删除 它 。 

立即 删除 快速 单元 测试 集中 的 任何 遗留 集成 测试 。 









































10.3.3 ”测试 驱动 开发 和 验收 测试 驱动 开发 的 重合 部 分 


当 团 队 同 时 基于 TDD 和 ATDD 开 展 工作 时 ,一 个 令 人 焦虑 的 事情 是 有 些 测试 不 可 避免 地 会 出 
现 重合 现象 ,尤其 是 当 所 有 任务 都 是 正确 的 、 通 过 测试 驱动 模式 完成 的 情况 下 。 绝 大 多 数 验 收 测 
试 通常 代表 一 些 功能 上 的 兴趣 点 , 并且 展示 了 系统 如 何 和 其 他 系统 进行 交互 。 在 做 TDD 时 , 你 也 
将 通过 测试 驱动 用 户 接口 层 的 开发 。 这 是 重复 的 劳动 吗 ? 

的 确 ， 基 于 接口 层 的 测试 看 起 来 非常 类 似 。 然 而 , 测试 的 受众 和 目的 是 完全 不 同 的 。 没有 人 
会 阅读 你 的 程序 员 测 试 。 相 反 ， 设 计 验 收 测试 就 是 让 任何 人 都 可 以 读 取 。 

客户 定义 的 测试 将 针对 部 分 端 对 端 功能 提供 大 范围 的 覆盖 率 。 不 能 期 望 这 些 测 试 会 覆盖 所 有 
可 能 的 排列 组 合 ， 因 为 这 会 使 测试 运行 时 间 变 得 非常 长 。 可 以 通过 TDD 模 式 编写 单元 测试 , 竭力 
快速 通过 一 组 数量 庞大 的 排列 组 合 。 

从 设计 的 角度 来 说 ， 重 复 的 代码 量 应 该 要 很 小 。 在 设计 良好 的 系统 中 ， 用 户 接口 层 非常 薄 ， 
主要 作为 商业 领域 类 ( 这 里 应 该 还 有 许多 非 用 户 接口 层 的 类 ) 的 代表 。 因 此 ， 针 对 这 些 用 户 接口 
层 的 单元 测试 ， 仅 仅 需要 验证 任务 被 正确 地 授权 。 


单纯 地 从 测试 的 角度 来 看 ,同时 拥有 单元 测试 和 验收 测试 的 好 处 是 ,提供 了 一 层 额 外 的 保护 。 
你 的 单元 测试 不 可 避免 地 无 法 覆盖 重要 的 场景 。 在 单元 级 之 上 创建 一 组 由 不 同人 员 参 与 定义 的 测 
试 , 将 会 带 来 有 价值 的 安全 保障 。 编 写 一 些 测试 来 表征 商业 模式 中 没 考虑 到 的 场景 ,反之 亦 然 ( 但 
不 要 忘 了 ， 网 是 由 很 多 孔洞 组 成 的 )。 


缺陷 意味 着 有 错误 的 或 遗漏 掉 的 单元 测试 。 可 以 通过 测试 驱动 的 方式 弥补 缺陷 。 先 编写 一 个 
可 以 重 现 故 障 的 测试 ， 然 后 修改 代码 使 单元 测试 ( 以 及 任何 相关 的 其 他 验收 测试 ) 通过 。 
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10.4 变换 优先 级 假设 


本 书 中 曾 提 过 , 你 编写 的 下 一 个 测试 , 就 是 对 系统 有 微量 增强 的 那 一 个 。 如 果 严 格 遵循 TDD 
的 流程 , 尝试 在 继续 前 进 之 前 演示 测试 故障 , 那么 你 将 体会 到 这 对 大 步 迈 进 的 意义 ( 详 见 3.5 节 )。 
遵循 简单 设计 的 最 后 一 条 规则 一 一 最 小 化 类 和 方法 的 数量 ( 参见 6.2 节 ) 一 一 将 有 助 于 避免 过 度 
设计 ， 而 仅 编写 需要 的 代码 。TDD 的 第 三 条 规则 (〈 详 见 3.4 节 ) 也 提 到 过 ， 只 需要 编写 能 使 测试 
通过 的 代码 。 

小 步骤 非常 重要 ， 因 为 在 系统 逐步 增强 的 过 程 中 , 较 大 的 步骤 将 浪费 更 多 时 间 。 构造 一 个 过 
分 泻 染 、 完 全 超出 测试 需求 的 方案 需要 从 大 段 代 码 中 详细 检查 相关 测试 。 

通过 增 量 演进 来 发 展 系统 是 成 功 的 TDD 需 要 具备 的 条 件 。 经 常备 份 以 及 需要 时 尝试 不 同 的 方 
式 ， 将 加 快 进度 。( 你 需要 一 个 好 的 版 本 管理 工具 来 支持 修改 。) 

Robert C. Martin 的 TPP 是 决定 下 一 个 测试 的 男 一 个 工具 ，TPP 提 出 了 变换 优先 级 的 一 个 列表 。 
变换 表示 代码 从 特定 性 到 增加 些许 一 般 性 。 利 用 TPP， 你 可 以 进行 测试 的 最 高 优先 级 变换 。 前 提 
是 要 遵循 TPP 可 以 增 量 地 演进 、 发 展 系统 。TPP 的 使 用 有 助 于 避免 测试 驱动 中 的 一 些 糟粕 。 

你 可 以 在 网 址 http://web.archive.org/web/20130113152824/ 和 http://cleancoder.posterous.com/ 
the-transformation-priority-premise 中 找到 最 初 的 优先 级 列表 。 优先 级 列表 并 不 是 非常 简单 的 技巧 ， 
而 是 前 提 条 件 。 其 他 的 博客 提出 了 略 做 变形 的 优先 级 列表 。 




























































































10.4.1 了 解 变 


TPP 听 起 来 有 些 复 杂 。 具 体 的 例子 胜 过 千言 万 语 。 我 们 将 从 TDD 的 角度 逐步 深入 Soundex: 
用 初始 排列 顺序 的 优先 级 变换 列表 (Transform Priority List, TPL ) 编写 的 第 一 个 例子 。 
































变 换 说 明 
((]nil) 将 没有 实现 的 代码 替换 为 nil 
(nil—constant) 将 nil 末 换 为 一 个 常量 
(constant 一 constant+) 将 一 个 简单 常量 替换 为 一 个 复杂 常量 
(constant—scalar) 将 一 个 常量 替换 为 一 个 变量 或 参数 
(statement—>statements) 增加 无 条 件 语 句 
(unconditionalif) 分 离 执行 分 支 
(scalar 一 array) 将 一 个 变量 /参数 替换 为 一 个 数组 
(array 一 container) 将 一 个 数组 替换 为 一 个 复杂 容器 
(statement—recursion) 将 一 个 语句 替换 为 递归 调用 
(if— while) 将 一 个 条 件 判 断 语句 替换 为 循环 
(expression 一 function) 将 一 个 表达 式 替 换 为 一 个 函数 
(variable—assignment) 替换 一 个 变量 的 值 


( 资料 来 源 : http://en.wikipedia.org/wiki/Transformation Priority Premise ) 
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鉴于 我 们 已 经 解析 过 Soundex， 接 下 来 将 重点 讨论 变换 相关 的 代码 ， 其 他 部 分 会 一 笔 带 过 。 
第 一 个 测试 略 有 不 同 ， 我 们 将 处 理 填充 字符 "0": 





tpp/1/SoundexTest.cpp 

TEST(SoundexEncoding, AppendsZerosToWordForOneLetterWord) ( 
Soundex soundex; 
auto encoded = soundex.encode("A"); 


CHECK EQUAL("A000", encoded); 
} 


E 














译 测试 的 失败 代表 着 我 们 对 变换 的 第 一 个 需求 一 一 从 没有 任何 代码 到 返回 nil， 这 是 位 于 
TPL 项 端的 最 简单 变换 。 实 现 返回 nil 值 的 encode( ) 才 能 使 编译 test 通 过 …… 现 在 从 失败 的 单元 测 
试 开始 : 





























tpp/1/Soundex.h 
class Soundex { 
public: 
std::string encode(const std::string& word) const { 
return nullptr; 
} 
h 


通过 将 nil 变 换 为 常数 ， 我 们 修补 了 单元 测试 错误 ， 这 是 TPL 中 的 第 二 项 。 

















tpp/2/Soundex.h 


class Soundex { 
public: 
std::string encode(const std::string& word) const { 
» return "A000"; 
J 
}; 


10.4.2 三 角 法 


之 前 创建 Soundex 时 , 我 们 去 除了 硬 编码 的 常量 "A", 将 其 作为 重 构 的 一 个 步骤 。 为 了 消除 产 
品 代码 中 的 重复 字符 串 ， 引 入 一 个 变量 。 同 时 ,我 们 决定 删除 产品 代码 中 的 特定 硬 编码 值 ， 让 它 
和 测试 名 RetainsSoleLetterOfOneLetterWord 中 蕴含 的 目标 一 致 。 我 们 在 操作 时 遵循 了 TPP 精 神 : 
通过 增 量 方式 逐步 地 一 般 化 代码 。TPL 中 的 每 个 变换 代表 着 从 特定 性 到 增加 些许 一 般 性 的 变化 。 

这 次 ， 我 们 将 使 用 三 角 法 去 除 代 人 码 中 的 硬 编码 《测试 驱动 开发 》 中 首次 提出 了 三 角 法 。 通 
过 增加 第 二 个 测试 用 例 ， 三 角 法 从 不 同 的 角度 接近 了 相同 的 行为 。 


















































tpp/3/SoundexTest.cpp 


TEST(SoundexEncoding, AppendsZerosToWordForOneLetterWord) ( 
CHECK EQUAL ( "A000", soundex.encode("A")); 
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» CHECK EQUAL ("B000", soundex.encode("B")); 
J 


引入 if 语句 可 以 让 失败 的 测试 通过 : 如 果 单 词 的 首 字母 是 A， 则 返回 "A100" ， 否 则 就 返回 
"B100"。 引 入 的 代码 表示 变换 ( unconditional 一 if ), 我 们 选择 优先 级 更 高 的 变换 ( constant scalar )。 























tpp/3/Soundex.h 
class Soundex { 
public: 
std::string encode(const std::string& word) const { 
return word + "000"; 
} 
}; 


10.4.3 ”浏览 测试 列表 


下 一 个 测试 在 哪 ? 我 们 想 尽 可 能 用 最 高 优先 级 的 变换 来 增加 代码 。 让 我 们 看 看 列表 里 还 剩 下 
哪些 测试 : 


PadsWithZerosToEnsureThreeDigits 
ReplacesConsonantsWithAppropriateDigits 
ReplacesMultipleConsonantsWithDigits 
LimitsLengthToFourCharacters 
IgnoresVowellikeLetters 

IgnoresNonAlphabetics 

CombinesDuplicateEncodings 

UppercasesFirstLetter 
IgnoresCaseWhenEncodingConsonants 
CombinesDuplicateCodesWhen2ndLetterDuplicateslst 
DoesNotCombineDuplicateEncodingsSeparatedByVowels 


现在 有 一 个 无 条 件 语句 用 到 了 一 个 常量 和 一 个 标量 。 因 为 无 需 担心 从 个 、nil、array 和 if 的 变 
所 以 就 减少 了 和 TPL 的 关联 部 分 。 
如 果 需 要 处 理子 字符 串 、 字 符 串 长 度 , 或 将 字母 变 成 大 写 , 任何 代码 都 需要 引入 一 次 函数 调 
Ho (RW, 如 果 带 着 创意 去 思考 , 不 需要 函数 调用 的 方式 可 能 也 行 得 通 。) 暂时 先 绕 开 看 上 去 需 
要 函数 调用 的 测试 ， 查 找 其 他 更 高 优先 级 的 测试 。 

大 多 数 不 需 要 函数 调用 的 测试 可 能 需要 条 件 语句 。 在 引入 条 件 判断 代码 之 前 , 硬 编码 特定 常 
量 只 能 到 这 一 步 了 。 我 们 先 处 理 编码 : 





换 
































tpp/4/SoundexTest.cpp 


TEST(SoundexEncoding, ReplacesConsonantsWithAppropriateDigits) ( 
CHECK EQUAL("A100", soundex.encode("Ab")); 


} 
用 (unconditional 一 if ) 变换 让 代码 变 得 更 加 通用 。 
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tpp/4/Soundex.h 


class Soundex { 
public: 


std::string encode(const std::string& word) const { 


std::string code(""); 
code += word[0]; 
if (word[1]) 

code += "100"; 
else 

code += "000"; 
return code; 


VYVYVYVYY 


}; 
使 用 TPP 时 可 以 稍微 放松 要 求 ， 避 免 过 早 地 禁 











代码。 你 仍然 要 移 除 重复 的 代码 ,保持 良 好 





的 表达 性 ,但 可 以 暂时 先 留 下 简单 的 if 语 句 和 while 循 环 。 你 会 发 现 ， 避 人 免 使 用 复杂 形式 ( 如 三 


元 运算 符 和 for 循 环 ) 更 利于 代码 重 构 。 








我 们 的 方案 过 于 生 搬 硬 套 ,但 这 并 不 是 什么 问题 。 它 并 不 清晰 ， 而 且 有 重复 的 代码 ， 这 是 个 


问题 ， 我 们 需要 重 构 。 


tpp/5/Soundex.h 


class Soundex { 
public: 


std::string encode(const std::string& word) const { 


std::string code(""); 


> code += head(word) + encodeTail (word); 
> return zeroPad(code); 
} 
» char head(const std::string& word) const ( 
» return word[0]; 
» } 
» std::string encodeTail(const std::string& word) const ( 
> if (word[1] == 0) return ""; 
» return "1"; 
» ) 
» std::string zeroPad(const std::string& code) const { 
» if (code[1] != 0) 
» return code + "00"; 
» return code + "000"; 
» j 
}; 





























zeroPad() 中 的 代码 还 是 有 些 糟糕 ， 不 是 吗 ? 下 面 进 行 第 二 轮 重 构 : 


tpp/6/Soundex.h 





std::string zeroPad(const std::string& code) const ( 
» return code + (hasEncodedCharacters(code) ? "00" : "000"); 
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} 


> bool hasEncodedCharacters(const std::string& code) const { 
» return code[1] != 0; 
>} 
我 刚才 提 到 了 哪些 像 三 元 运算 符 这 样 的 的 奇妙 构想 ? 看 来 删除 一 些 重复 代码 是 合理 的 。 如 果 
它 带 来 任何 问题 ， 我 们 可 以 在 备份 之 后 将 其 删除 。 


增加 一 个 断言 以 便 对 另 一 个 辅音 字母 编码 。 在 实现 方面 , 我 们 可 以 引入 一 个 if 语 句 , 但 这 只 
会 引入 一 个 复制 的 构造 体 ， 不 会 使 代码 变 得 更 加 通用 。 寻 找 下 一 个 最 高 优先 级 的 变换 :( 标量 一 
数组 )。 























tpp/7/SoundexTest.cpp 


TEST(SoundexEncoding, ReplacesConsonantsWithAppropriateDigits) { 
CHECK EQUAL("A100", soundex.encode("Ab")); 
CHECK EQUAL ( "A200", soundex.encode("Ac")); 

} 


tpp/7/Soundex.h 


class Soundex { 

public: 

» Soundex() 1 

> codes ['b'] = "1"; 

> codes ['c'] = "2"; 

» j 
IS wes 
std::string encodeTail(const std::string& word) const ( 

if (word[1] == 0) return ""; 

» return codes [static cast<size t»(word[1])]; 
} 
IL ws 

» private: 

» std::string codes [128]; 

}; 


上 述 代码 完成 了 辅音 字母 列表 ， 还 对 表达 性 做 了 一 点 重 构 。 


























tpp/8/Soundex.h 
class Soundex { 
public: 
Soundex() { 
> initializeCodeMap(); 
} 
void initializeCodeMap() { 
codes_['b'] = codes_['f'] = codes_['p'] = codes_ ['v'] i 
codes ['c'] = codes_['g'] = codes ['j'] = codes ['k'] = 
'] = codes ['s'] = codes ['x'] = codes ['z'] = "2"; 


codes ['q 
codes ['d' 
l' 


] 
] = codes ['t'] = "3"; 
codes ['0'] = 


= "4"; 
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std::string encodeTail(const std::string& word) const ( 
if (word[1] == 0) return "" 


» return codeFor(word[1]); 
} 
» std::string codeFor(char c) const { 
» return codes [static cast<size t»(c)]; 
» J 
VO A 

















次 浏览 列表 中 剩 下 的 测试 。 大 部 分 看 起 来 仍然 需要 引入 一 次 函数 调用 。 比 函数 调用 优先 
级 更 高 的 是 支持 循环 的 两 个 变换 : 一 个 通过 while 循 环 , 男 一 个 通过 递归 。 测试 ReplacesMultiple- 
ConsonantsWithDigits 看 起 来 需要 一 个 循环 方案 。 

TPL 的 之 后 版 本 包含 了 一 些 优先 级 变更 。 我 们 用 的 是 最 初 的 版 本 ， 在 这 个 版 本 中 ,递归 比 循 
环 优先 级 更 高 。 其 重点 已 经 变 成 了 辩论 的 话题 。 在 功能 性 语言 ( 如 Erlang 或 者 Clojure ) P, Ma 
能 需要 一 个 递归 的 解决 方案 。 在 C++ 中 ， 选 择 哪 种 方案 完全 取决 于 你 自己 。 你 可 能 会 比较 递归 方 
案 和 循环 方案 的 性 能 。 

我 们 将 继续 使 用 初始 版 本 中 的 TPL 排 序 ， 看 看 接 下 来 会 发 生 什么 。 

通过 TPP 的 方式 逐步 增加 代码 ， 使 每 一 步 都 是 微小 、 增 量 的 变化 。 我 们 并 没有 要 求 大 规模 地 
修改 现 有 代码 ， 对 递归 的 引入 同样 如 此 。 












































tpp/9/SoundexTest.cpp 


TEST(SoundexEncoding, ReplacesMultipleConsonantsWithDigits) { 
CHECK EQUAL("A234", soundex.encode("Acd0")); 
} 


tpp/9/Soundex.h 


std::string encode(const std::string& word) const { 
std::string code(""); 
» code += head(word); 
» encodeTail(word, code); 
return zeroPad(code); 
F 
TP AEST 
» void encodeTail(const std::string& word, std::string& code) const ( 
if (word[1] == 0) return; 
» code += codeFor(word[1]); 
» encodeTail(tail(word), code); 
} 
> std::string tail(const std::string& word) const { 
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» return word.substr(1); 
>} 
还 存在 两 个 问题 。 首 先 ， 它 不 能 正常 工作 。 我们 需要 调整 进行 编码 的 字符 '9' 的 数量 。 其 次 ， 
测试 调用 了 函数 substr() ， 我 们 选择 引入 递归 ， 因 为 它 比 函数 调用 的 优先 级 更 高 。 


TPP 是 前 提 和 正在 开展 的 工作 ,但 不 是 解决 所 有 编程 挑战 的 灵丹妙药 ， 也 不 是 一 组 严格 的 规 
定 。TPL 的 目的 是 帮助 你 找到 下 一 个 最 小 增 量 。 在 例子 中 ， 递 归 方 案 表 明 它 是 一 个 良好 的 增 量 步 
JE. 这 一 点 非常 重要 。 对 优先 级 规则 来 说 ,引入 函数 调用 的 方案 看 起 来 是 可 以 接受 的 (递归 方案 
处 理 集合 一 字符 串 仅 仅 是 一 组 字符 的 集合 一 常常 需要 从 其 尾部 抽取 数据 的 函数 , 通常 这 就 是 最 佳 
方案 )。 

解决 字符 填充 问题 的 方法 有 很 多 种 ， 其 中 之 一 就 是 初始 化 一 个 用 来 表征 需要 填充 字符 '0' 的 
计数 器 或 字符 串 ， 然后 在 函数 encodeTail () 每 次 添加 编码 字符 时 ,递减 计数 絮 或 字符 串 。 然 而 ， 
这 需要 一 条 赋值 语句 ， 而 赋值 语句 在 优先 级 列表 中 处 于 低级 。TPL 中 更 简单 、 优 先 级 更 高 的 方法 
是 ， 在 函数 zeroPad() 中 考虑 字符 串 的 长 度 。 























































































































tpp/10/Soundex.h 


const static size t MaxCodeLength{4}; 
std::string zeroPad(const std::string& code) const ( 

» return code + std::string(MaxCodelength - code.length(), '0'); 
} 


我 们 意识 到 函数 encodeTaiL() 可 以 “ 反 过 来 ”用 ， 如 果 调 用 时 传人 字符 串 的 尾部 〈 而 不 是 
完整 的 字符 串 )， 那 么 它 可 以 操作 字符 串 的 第 一 个 字符 。 修 改 允 许 我 们 做 一 些 额外 的 重 构 以 增强 
代码 的 表达 性 。 














tpp/11/Soundex.h 


std::string encode(const std::string& word) const ( 
std::string code(1, head(word)); 
encode(tail(word), code); 
return zeroPad(code); 
} 
void encode(const std::string& word, std::string& code) const { 
if (word.empty()) return; 
code += codeFor(head(word)); 
encode(tail(word), code); 
} 
const static size_t MaxCodeLength{4}; 
std::string zeroPad(const std::string& code) const { 
> return code + std::string(MaxCodeLength - code.length(), '0'); 
} 


RRENA n] AAE RES TERMAT ! 


LA AER HAA EW ERNE Soundex—$, Kžtencode() 清晰 地 表明 了 对 字符 
串 编码 的 策略 。 我 们 来 看 看 其 他 的 测试 。 这 里 选择 了 IgnoresVowelLikeLetters,， 它 看 起 来 只 需要 引 
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人 if 语句 。 


tpp/12/SoundexTest.cpp 


TEST(SoundexEncoding, IgnoresVowellikeLetters) { 
CHECK EQUAL("B234", soundex.encode("BAaEeIiOoUuHhYycdl")); 


} 

















未 作 任何 修改 的 情况 下 ， 测 试 通过 了 ! 像 往 常 一 样 ， 我 们 需要 思考 一 下 原因 3.5 ), 
但 现在 这 不 是 重点 。 如 果 要 想 严 格 遵守 TPP, 前 提 是 它 指导 我 们 将 最 小 的 增 量 逐步 合并 到 代码 中 。 
过 早 通过 的 测试 表明 ， 编 写 大 量 代码 的 可 能 性 不 大 。 


测试 通过 的 原因 是 codes_ 





























数组 对 并 不 包含 的 元 素 总 是 返回 null。 添 加 null 对 代码 没有 任何 改 

















变 。 接 着 我 们 发 现 ，IgnoresNonAlphabetics 也 是 基于 同样 原因 而 每 次 都 通过 。 
现在 引入 CombinesDuplicateEncodings。 


tpp/13/SoundexTest.cpp 











TEST(SoundexEncoding, CombinesDuplicateEncodings) { 
CHECK EQUAL (soundex.codeFor('f'), soundex.codeFor('b')); 
CHECK EQUAL (soundex.codeFor('g'), soundex.codeFor('c')); 
CHECK EQUAL (soundex.codeFor('t'), soundex.codeFor('d')); 
CHECK EQUAL("A123", soundex.encode("Abfcgdt")); 


} 


测试 运行 时 发 生 了 错误 一 一 std::length_error。 人 快速 查看 回溯 napi aU nh X 
现 问题 出 现在 函数 zeroPad0 中 。 如 果 一 个 字符 串 包含 三 个 以 上 的 字符 ， 那 么 zeroPad() 会 尝试 





创建 一 个 由 '0' 组 成 的 字符 串 ， 
这 是 否 意 味 着 应 该 将 焦 

为 这 需要 调用 函数 Length () 

序 抛 出 的 异常 终止 了 测试 的 执行 











但 字符 串 的 长 度 是 负数 。 
点 切换 到 LimitsLengthToFourCharacters? TPP 给 出 了 和 否定 的 答案 ， 因 


， 而 CombinesDuplicateEncodings 仅 仅 需 要 一 个 条 件 语句 。 然 而 ， 程 
Ts 无 法 看 到 测试 的 直接 故障 。 我 们 决定 先 找到 失败 的 测试 ,记录 





FÆ, 碰 到 问题 时 再 尝试 调整 代码 。 禁 用 这 个 测试 , 然后 开始 运行 LimitsLengthToFourCharacters。 


tpp/14/SoundexTest.cpp 


TEST(SoundexEncoding, LimitsLengthToFourCharacters) ( 
CHECK EQUAL(4u, soundex.encode("Dcdlb") . length()) ; 


} 


一 个 小 小 的 改动 (expressionofunction ) 让 测试 通过 了 。 


tpp/14/Soundex.h 


void encode(const std::string& word, std::string& code) const { 
» if (word.empty() || isFull(code)) return; 
code += codeFor(head(word)); 
encode(tail(word), code); 


} 


> bool isFull(std::string& code) const { 
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» return code.length() -- MaxCodeLength; 
>} 
FPES LA CombinesDuplicateEncodings , 不 出 所 料 , 测试 失败 了 。 WRK FIFRE IKRE E 
归 函 数 encode()， 将 其 作为 基准 ， 然 后 与 当前 添加 的 字符 进行 比较 。 为 了 避免 和 函数 head() 的 
名 称 产生 冲突 ， 我 们 为 测试 选取 了 男 一 个 名 字 。 





tpp/15/Soundex.h 


std::string encode(const std::string& word) const { 
std::string code(1, head(word)); 
encode(tail(word), code, head(word)); 
return zeroPad(code); 


Y 


} 
void encode (const std::string& word, std::string& code, 
char H) const { 
if (word.empty() || isFull(code)) return; 
std::string digit = codeFor(head(word)); 
if (digit != codeFor(H)) 
code += codeFor(head(word)); 
encode(tail(word), code, head(word)); 


Y 


Yyyy 


} 


我 们 的 方案 需要 重 构 。 因 为 要 用 字符 串 的 头 部 和 尾部 在 函数 encode ( ) 中 编码 ， 所 以 我 们 传 
递 了 整个 字符 串 。 同 时 , 选择 一 个 不 会 引起 冲突 的 名 称 , 添加 一 个 辅助 函数 , 以 说 明 测 试 的 用 途 。 
(因为 encode( ) 函数 的 每 行 代码 都 被 修改 了 ， 所 以 并 没有 重点 突出 ， 新 增加 的 1sSameEncoding 
AsLast() 也 是 如 此 。) 











tpp/16/Soundex.h 


std::string encode(const std::string& word) const ( 

std::string code(1, head(word)); 
» encode(word, code); 

return zeroPad(code); 

} 

void encode(const std::string& word, std::string& code) const { 
auto tailToEncode = tail(word); 
if (tailToEncode.empty() || isFull(code)) return; 


auto digit = codeFor(head(tailToEncode)); 
if (isSameEncodingAsLast(digit, word)) 
code += digit; 
encode(tailToEncode, code); 
} 
bool isSameEncodingAsLast( 
const std::string digit, 
const std::string& word) const { 
return digit !- codeFor(head(word)); 





上 


类 似 的 测试 CombinesDuplicateCodesWhen2ndLetterDuplicateslst 也 应 该 需要 大 致 相同 的 变换 。 
(我 们 将 首 字 母 小 写 的 字符 串 指 定 为 断言 的 期 望 值 , 因为 还 没有 处 理 在 Soundex 编 码 时 首 字母 大 写 
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的 情况 。) 


tpp/17/SoundexTest.cpp 


TEST(SoundexEncoding, CombinesDuplicateCodesWhen2ndLetterDuplicateslst) { 
CHECK EQUAL ( "b230", soundex.encode("bbcd")); 
} 


测试 通过 了 ， 因 为 已 经 让 递归 函数 encode( ) 人 处 理 了 整个 编码 过 程 。 同 样 ， 男 一 个 类 似 的 测 
试 也 通过 了 。 


























tpp/18/SoundexTest.cpp 


TEST(SoundexEncoding, DoesNotCombineDuplicateEncodingsSeparatedByVowels) { 
CHECK EQUAL("J110", soundex.encode("Jbob")); 
} 


所 有 的 测试 都 通过 了 ,我 们 反倒 有 些 不 安 , 因此 ,通过 另 一 个 场景 减轻 我 们 的 担心 ， 它 也 通 





tpp/18/SoundexTest.cpp 


TEST(SoundexEncoding, CombinesMultipleDuplicateEncodings) ( 
CHECK EQUAL("J100", soundex.encode("Jbbb")); 
} 


(还 有 一 种 可 能 的 场景 : 基于 H 和 W 可 能 会 被 区 别 对 竺 这样 的 事实 , 这 取决 于 你 和 谁 交 流 。 
为 上 次 构造 Soundex 时 忽略 了 这 个 潜在 的 区 别 ， 所 以 我 们 将 继续 名 略 ， 让 事情 变 得 简单 。) 


先 大 写 首 字母 ， 这 也 需要 更 新 CombinesDuplicateCodesWhen2ndLetterDuplicateslst 的 期 望 值 。 








tpp/19/SoundexTest.cpp 

TEST(SoundexEncoding, CombinesDuplicateCodesWhen2ndLetterDuplicateslst) { 
CHECK EQUAL("B230", soundex.encode("bbcd")); 

} 

TEST(SoundexEncoding, UppercasesFirstLetter) { 
CHECK EQUAL("A", soundex.encode("abcd").substr(0, 1)); 

} 


这 个 变换 虽然 简单 ， 但 使 用 了 函数 调用 。 Mor disk :toupper() 的 代码 ， 但 我 并 不 认 
为 TPP 人 允许 做 这 件 事 情 。) 你 已 经 看 过 upper() 的 实现 ， 这 里 就 不 列举 了 。 























tpp/19/Soundex.h 


std::string encode(const std::string& word) const ( 
» std::string code(1, toupper(head(word))); 
encode(word, code); 
return zeroPad(code); 


} 


"m NEA o PN 点 思考 ， 如 果 输 入 字符 串 的 字母 相同 , 但 第 
二 个 字母 小 写 ， 那 么 会 怎么 ARES 








个 字母 大 写 ， 而 第 


W 
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tpp/20/SoundexTest.cpp 


TEST(SoundexEncoding, IgnoresCaseWhenEncodingConsonants) { 
CHECK EQUAL (soundex.encode("BCDL"), soundex.encode("bcdl")); 
3 


啊 哈 ! 出 错 了 ， 以 下 是 一 个 快速 解决 方案 : 


tpp/20/Soundex.h 


std::string codeFor(char c) const { 
return codes [static cast<size t>(lower(c))]; 


} 




















完成 了 吗 ? 还 没 添加 PadsWithZerosToEnsureThreeDigits。 它 直接 通过 了 ， 但 选择 它 的 目的 是 
为 了 文档 记录 。 


tpp/21/SoundexTest.cpp 

TEST(ASoundexEncoding, PadsWithZerosToEnsureThreeDigits) ( 
CHECK EQUAL("I000", soundex.encode("I")); 

} 




















第 二 次 总 是 显得 容易 些 ， 但 这 次 的 成 功 更 多 地 归功 于 TPP 流 程 的 使 用 ， 而 非 对 问题 的 理解 。 
我 们 做 了 一 些 主观 选择 ， 可 能 没有 严格 遵循 TPP， 但 最 终结 果 说 明了 一 切 。 


以 下 是 TPP 测 试 驱 动 的 核心 算法 : 















































tpp/21/Soundex.h 


std::string encode(const std::string& word) const { 
std::string code(1, toupper(head(word))); 
encode(word, code); 
return zeroPad(code); 


F 


void encode(const std::string& word, std::string& code) const { 
auto tailToEncode = tail(word); 
if (tailToEncode.empty() || isFull(code)) return; 


auto digit - codeFor(head(tailToEncode)); 
if (isSameEncodingAsLast(digit, word)) 


code += digit; 


encode(tailToEncode, code); 


} 
以 下 是 非 TPP 测 试 驱 动 的 核心 算法 : 




















c2/40/Soundex.h 


std::string encode(const std::string& word) const { 
return stringutil::zeroPad( 
stringutil::upperFront(stringutil::head(word)) + 
stringutil::tail(encodedDigits(word)), 
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MaxCodeLength) ; 
} 


std::string encodedDigits(const std::string& word) const { 
std::string encoding; 
encodeHead(encoding, word); 
encodeTail(encoding, word); 
return encoding; 


} 


void encodeHead(std::string& encoding, const std::string& word) const { 
encoding += encodedDigit(word.front()); 


) 


void encodeTail(std::string& encoding, const std::string& word) const ( 
for (auto i = lu; i < word.length(); i++) 
if (!isComplete(encoding)) 
encodeletter(encoding, word[i], word[i - 1]); 


) 


void encodeletter(std::string& encoding, char letter, char lastLetter) const ( 
auto digit - encodedDigit(letter); 
if (digit !- NotADigit && 
(digit !- lastDigit(encoding) || charutil::isVowel(lastLetter))) 
encoding += digit; 


} 
我 知道 自己 应 该 维护 哪个 版 本 。TPP 不 仪 能 够 产生 更 简洁 的 算法 ， 花 费 的 精力 也 更 少 。 
尽管 很 好 , 但 TPP 仅 仅 是 一 个 前 提 。 我 越 用 它 ， 就 越 对 产 出 感到 开心 。 它 是 一 个 高 级 的 课题 ， 

是 深入 理解 TDD 的 美味 大 餐 。 

TPP 要 求 预先 思考 TDD 流 程 中 的 每 个 路 径 。 必 须 考 虑 以 下 几 点 。 

a 当前 测试 的 哪个 实现 具有 更 高 优先 级 ?能 想 出 更 富 创 意 的 方法 吗 ? 

Q 相对 于 即将 着 手 的 下 一 个 测试 ， 是 否 存 在 比 其 优先 级 更 高 的 测试 ? 

a 其 余 的 测试 是 什么 ”对 TPP 而 言 ， 维 护 一 个 测试 列表 (参见 2.3 节 ) 显得 尤为 重要 。 


正如 本 书 中 介绍 的 一 样 ， 即 使 不 引入 TPP，TDD 也 能 顺畅 地 工作 。 但 是 使 用 TPP 会 做 得 更 加 
出 色 。 

































































10.5 ”编写 断言 

和 其 他 的 TDD 实 践 者 交流 的 越 多 , 就 越 会 发 现 有 很 多 实现 TDD 的 方法 。 假设 你 幸运 地 避免 了 
关于 “唯一 正确 方法 ”的 激烈 争吵 ， 例 如， 你 会 发 现 有 些 开发 者 极力 推 尝 “每 个 测试 对 应 一 个 断 
言 ”， 而 其 他 人 认为 这 是 一 个 过 分 的 目标 。 你 会 发 现 有 些 实践 者 坚持 认为 ， 测 试 的 名 称 应 该 遵循 
同样 的 格式 ， 而 其 他 开发 者 根本 不 关心 这 个 。 

这 里 有 对 错 之 分 吗 ?” 绝 大 多 数 时 候 你 会 发 现 , 站 在 对 立 立场 的 人 们 对 每 一 个 论点 都 有 深刻 而 
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T 


理性 的 思考 。 


你 应 该 已 经 在 本 书 中 注意 到 了 我 的 风格 , 毫 无 疑问 , 你 会 觉得 一 些 事情 比 另 一 些 事情 更 引 人 
入 胜 。 我 的 建议 是 , 在 轻易 丢弃 之 前 , 尝试 一 些 性 质 不 同 或 你 不 认同 的 事情 。 你 可 能 会 发 现 惊喜 。 
很 早 之 前 我 就 回避 了 “一 个 测试 对 应 一 个 断言 ”( 参见 7.3 节 )， 坚 持 这 个 原则 的 话 ， 在 99% 的 时 候 
你 会 发 现 其 价值 所 在 。 

基本 上 , 除了 遵循 IDD 流程 和 产 出 高 质量 代码 , 其 余 的 事情 更 主要 在 于 风格 和 偏好 。 请 记 住 ， 
寻找 更 好 的 做 事 方式 是 你 的 职责 。 不 管 对 我 的 风格 , 还 是 你 自己 风格 的 感受 如 何 , 希望 不 要 在 两 
年 之 后 发 现 彼此 仍 在 用 同样 的 方式 工作 。 

























































































10.5.1 断言 一 行为 一 排列 


TDD 中 “ 红 -- 绿 -- 重 构 ” 的 循环 顺序 是 固定 的 , 但 在 测试 中 编写 这 些 语句 的 顺序 却 是 灵活 的 。 
许多 开发 者 采取 由 上 而 下 的 开发 方式 。 他 们 首先 编写 排列 部 分 ， 其 次 是 行为 部 分 ， 最 后 是 断言 。 
这 种 方法 没有 什么 错误 ( 恰巧 我 也 常常 采用 这 种 方法 )， 但 如 果 先 编写 断言 部 分 ， 或许 会 更 好 。 

到 目前 为 止 , 你 已 经 习惯 了 针对 不 断 完善 的 产品 代码 编写 测试 程序 。 为 不 存在 的 测试 编写 断 
言 的 想法 似乎 并 不 应 该 让 人 感到 过 于 震惊 。 但 为 什么 要 这 人 么 做 呢 ? 

先 编写 断言 部 分 使 你 思考 增加 这 些 行为 的 目的 , 并 进一步 推动 你 来 描述 这 对 已 经 完成 的 目标 
意味 着 什么 。 如 果 这 一 步 很 困难 ， 很 可 能 是 因为 你 还 没有 掌握 足够 的 信息 来 继续 编写 测试 。 

更 重要 的 是 , 先 编写 断言 部 分 有 助 于 从 意图 着 手 编程 ， 从 而 得 到 更 加 清晰 的 测试 。 你 的 断言 
将 是 意图 的 声明 。 相 反 ,， 如 果 已 经 编写 了 排列 和 行为 部 分 , 那么 断言 部 分 就 更 像 是 基于 特定 实现 
WAS T o 









































































































































10.5.2 ”示例 程序 优先 ， 或 至 少 第 二 


让 我 们 运行 一 个 简单 的 例子 。 我 们 需要 一 个 针对 GeoServer 的 测试 : 当 用 户 不 再 被 跟踪 时 ， 
返回 空 的 位 置信 息 。 





c9/18/GeoServerTest.cpp 


TEST(AGeoServer, AnswersUnknownLocationWhenUserNoLongerTracked) { 
CHECK TRUE(locationIsUnknown(aUser)); 
} 


虽然 我 们 并 不 知道 如 何 实现 验证 输出 结果 的 代码 , 但 我 们 知道 输出 应 该 是 什么 样 的 , 并 加 以 
描述 。 在 测试 集中 ， 我 们 定义 了 一 个 用 来 处 理 默认 和 出 错 行为 的 函数 。 























c9/18/GeoServerTest.cpp 
TEST GROUP(AGeoServer) 1 
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Z ues 
> bool locationIsUnknown(const string& user) { 
» return false; 
» } 
}; 


验证 完 测 试 失败 之 后 ， 开 始 定义 行为 部 分 。 


c9/19/GeoServerTest.cpp 


TEST(AGeoServer, AnswersUnknownLocationWhenUserNoLongerTracked) 1 
» server.stopTracking(aUser); 


CHECK TRUE(locationIsUnknown(aUser)); 
} 


让 测试 名 成 为 指导 方针 ， 这 里 提供 一 个 排列 : 





c9/20/GeoServerTest.cpp 


TEST(AGeoServer, AnswersUnknownLocationWhenUserNoLongerTracked) { 
» server.track(aUser); 


server.stopTracking(aUser); 


CHECK TRUE(locationIsUnknown(aUser)); 
j 


最 后 ， 让 故障 成 为 指导 方针 ， 这 里 提供 了 函数 LocationIsUnknown () 的 实现 。 





c9/20/GeoServerTest.cpp 


TEST GROUP(AGeoServer) { 
LP xs 


bool locationIsUnknown(const string& user) { 
auto location = server.locationOf(user); 


return location.latitude() -- numeric limits«double»::infinity(); 


» 
» 
» 
» 
» } 
}; 


“简直 丑陋 极 了 ”， 有 人 这 么 说 。 在 Location 类 中 增加 一 个 功能 用 以 判断 一 个 位 置 
知 的 "， 并 修改 LocationIsUnknown() 的 实现 。 








c9/21/GeoServerTest.cpp 


TEST GROUP(AGeoServer) { 
VJ s 
» bool locationIsUnknown(const string& user) { 
» return server.locationOf(user).isUnknown(); 
» } 
}; 


我 们 马上 意识 到 辅助 函数 已 经 不 再 发 挥 作用 ， 于 是 我 们 彻底 删除 了 它 。 
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c9/22/GeoServerTest.cpp 


TEST(AGeoServer, AnswersUnknownLocationWhenUserNoLongerTracked) { 
server.track(aUser); 


server.stopTracking(aUser); 


CHECK TRUE(server.locationOf(aUser).isUnknown()); 
} 


HEY 重点 是 什么 ? 或许 从 一 开始 就 应 该 用 这 种 方式 设计 Location 类 , 并 立即 编写 单行 的 断言 。 

也 许 是 ,也 许 不 是 。 重 要 的 是 断言 最 终 是 一 个 简单 的 声明 ， 而 不 在 于 它 是 如 何 实现 的 。 你 将 
经 常 需 要 密集 、 详 细 的 代码 语句 来 验证 测试 ， 即 使 不 是 从 声明 断言 的 用 意 开始 的 ， 你 仍然 需要 从 
中 抽取 部 分 代码 来 放 进 一 个 辅助 函数 中 。 

需要 多 行 声 明 的 断言 就 留 给 读者 实践 了 。 

































































c9/23/GeoServerTest.cpp 


TEST(AGeoServer, AnswersUnknownLocationWhenUserNoLongerTracked) { 
server.track(aUser); 


server.stopTracking(aUser); 


// 读 取 数 据 很 慢 ， 修复 这 个 问题 

auto location = server.locationOf(aUser); 

CHECK EQUAL(numeric limits«double»::infinity(), location.latitude()); 
} 


EAR Tn REMEI TIA AR, BERRE CTK (CHECKA LH 
了 前 一 行 返回 的 位 置 )。 读 者 还 需要 思考 如 何 将 两 行 断言 合成 一 个 概念 ( 即 用 户 的 位 置信 息 是 未 
知 的 )。 

















10.6 结束语 


你 在 这 一 章 学 习 了 TDD 的 一 些 边 边 角 角 的 知识 。 就 TDD 而 言 ， 这 就 是 全 部 内 容 了 ! 


不 , 这 只 是 个 玩笑 而 已 , 事情 并 非 这 样 。 本 书 提供 的 内 容 能 让 你 开始 深入 挖掘 TDD, 但 TDD 
的 更 多 方面 有 待 你 去 探索 和 发 现 。 世 界 各 地 的 测试 驱动 开发 者 正在 尝试 使 用 TPP， 并 想 知 道 他们 
到 底 能 在 这 条 路 上 走 多 远 。 各 地 的 行为 驱动 开发 者 ( 请 通过 google 搜 索 BDD ) 正在 寻找 进一步 消 
除 商 业 和 开发 团队 间 差 别 的 方法 。 验 收 测 试 驱动 开发 者 正在 努力 尝试 更 好 地 理解 TDD 和 ATDD 之 


间 的 界限 。 10 o 


相对 于 现实 存在 的 挑战 ( 比如， 如 何 让 一 个 软件 开发 团队 通过 TDD 获 得 成 功 )，TDD 的 具体 
细节 相对 比较 简单 。 一 旦 接受 了 TDD 模 式 , 你 会 希望 其 他 开发 者 理解 你 对 TDD 的 狂热 。 你 也 想 在 
实践 中 不 断 提 高 。 在 下 一 章节 中 ， 你 将 学 习 如 何 可 持续 地 发 展 TDD 的 策略 和 技巧 。 
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11.4 ”开场白 


你 已 经 学 习 了 什么 是 TDD、 它 能 做 些 什 么 、 怎 么 做 、 为 什么 这 样 做 以 及 何 时 使 用 它 。 如 果 持 
续 践 行 TDD 直 到 被 其 优势 所 征服 ,那么 你 迟早 会 变 成 测试 控 (test infected ) 一 一 你 会 坚持 将 它 
作为 主要 的 编程 工具 。 但 是 你 很 快 就 会 意识 到 , 并 不 是 每 个 人 都 这 么 认为 。 即 便 身 处 应 该 使 用 TDD 
方法 开发 程序 的 团队 ,你 还 是 会 感受 到 程度 不 一 的 坚持 和 支持 ; 也 会 遇 到 抵制 与 不 悄 ， 这 通常 是 
由 缺少 相关 信息 导致 的 。 即 便 你 的 团队 能 克服 最 初 的 障碍 让 每 个 人 都 使 用 TDD， 你 依然 会 发 现 ， 
保持 热情 不 减 是 一 大 挑战 一 一 正如 你 的 代码 。 维 持 TDD 绝 非 易 事 。 


本 章 将 提供 各 式 各 样 的 主意 来 帮助 你 维系 践 行 TDD 的 能 力 。 你 将 学 到 以 下 内 容 : 


口 怎样 回答 有 关 TDD 的 疑问 和 质疑 ; 

口 一 些 得 益 于 TDD 的 研究 ; 

口 怎样 避免 “讨厌 的 测试 死亡 缠绕 ”; 

a 怎样 用 结对 编程 维持 测试 驱动 ， 并 回顾 为 之 付出 的 努力 ; 
口 怎样 更 好 地 用 katass 和 dojos 践 行 TDD，; 

口 怎样 避免 测试 覆盖 度量 的 滥用 ; 

口 持续 集成 是 怎样 成 为 TDD 基 石 的 ; 

口 有 助 于 派生 TDD 标 准 的 问题 ; 

口 哪里 可 以 获得 更 多 TDD 社 区 的 实践 信息 。 

















































































































11.2 ”向 非 技 术 人 员 解 释 测试 驱 动 开发 


或 许 你 是 个 测试 控 , 但 你 的 热情 还 不 足以 改变 别人 的 信仰 , 尤其 是 那些 本 身 就 不 是 程序 员 的 
Ao 本 节 将 提供 两 个 工具 来 支撑 你 与 非 测试 控 的 对 话 。 首 先 ， 针 对 一 些 常见 的 问题 、 故 意 营 造 的 



































DÆ “Test Infected: Programmers Love Writing Tests," http://junit.sourceforge.net/doc/testinfected/testing.htm. 
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对 话 ， 提 供 一 些 简要 、 但 具有 强烈 推销 口吻 的 答案 。 其 次 ， 列 举 一 些 有 效 使 用 TDD 的 研究 成 果 ， 
它们 将 作为 有 力 的 论据 来 说 服 那些 在 倾听 你 说 话 前 需要 先 调研 的 人 。 


11.2.4. 测试 驱动 什么 


提问 : 什么 是 TDD? 
回答 : 它 是 程序 员 使 用 的 一 个 软件 开发 技巧 ， 用 以 增 量 地 设计 他 们 的 系统 。 
提问 : 它 是 什么 样子 的 ? 


回答 : 程序 员 将 工作 划分 为 小 块 的 任务 或 单元 。 对 于 每 一 小 块 任务 , 他 们 写 一 个 小 
的 测试 来 说 明代 码 应 该 怎样 工作 。 然 后 再 写 一 小 段 代码 使 测试 通过 。 一 旦 测试 通过 ,就 
要 确保 清理 掉 刚刚 编写 的 小 段 代码 中 的 所 有 设计 或 编码 缺陷 。 

提问 : 他 们 只 是 编写 单元 测试 ? 

回答 : 他 们 使 用 单元 测试 框架 ， 以 帮助 确立 新 加 的 一 段 代 码 该 怎样 工作 。 是 的 ， 他 
们 写 单元 测试 ， 但 这 些 测 试 同时 被 当 作 系统 工作 的 文档 。 

提问 : 他 们 只 是 编写 单元 测试 。 

回答 : 他 们 将 写 单元 测试 作为 增 量 设计 系统 的 方法 。 测 试 是 先 写 出 来 的 。 

提问 : 我 没有 看 出 这 与 单元 测试 的 区 别 。 先 写 测试 会 怎样 ? 

回答 : 你 会 得 到 两 个 不 同 的 结果 。 事 后 测试 不 会 改变 任何 东西 。 事 后 测试 或 许 能 帮 
助 程 序 员 发 现 一 些 问题 ， 然 而 仅仅 是 单元 测试 的 话 ， 则 不 足以 迫使 程序 员 改 善 设计 和 代 
码 质量 。 

提问 : TDD 真 的 能 改善 设计 和 代码 质量 吗 ? 

回答 : 有 些 研究 ( 参见 11.2.2 节 ) 表明 ， 应 用 TDD 会 减少 代码 缺陷 。 另 外 ，TDD 的 
使 用 允许 程序 员 持 续 地 改善 代码 和 设计 。 

提问 : TDD 怎 么 让 程序 员 比 以 前 更 多 地 修改 代码 呢 ? 

回答 : 程序 员 向 系统 中 加 入 的 每 一 小 块 代码 都 有 一 个 表述 其 行为 的 测试 。 这 意味 着 
系统 中 的 所 有 代码 都 经 过 了 测试 。 所 有 的 代码 都 有 测试 意味 着 , 程序 员 可 以 做 出 保持 代 
码 整 洁 的 小 型 改动 。 如 果 没 有 足够 的 测试 ， 那 现实 就 印证 了 那 负 格言 :“ 如 果 没 有 问题 ， 
就 不 要 修复 。” 

提问 : 那 又 怎么 样 呢 ? 如 果 不 必 担心 代码 的 整洁 度 ， 那 不 是 也 能 节约 时 间 吗 ? 

回答 : 有 研究 表明 ， 软 件 开 发 中 80% 的 时 间 都 用 于 维护 ( 不 是 修复 ) 软件 "。 随 着 
时 间 的 推移 , 代码 库 会 变 得 很 大 ,本 来 只 需要 花费 几 个 小 时 就 能 完成 的 任务 可 能 要 花费 
几 天 。 其 至 一 个 简 简 单单 的 问题 一 “在 这 种 情况 下 ,软件 做 了 什么 ? ”一 一 都 可 能 需 
要 程序 员 花 好 几 个 小 时 ， 扎 进 复 杂 的 代码 库 中 寻求 答案 。 

提问 : 这 是 在 说 程序 员 素 质 的 问题 吗 ? 难道 他 们 不 能 一 开始 就 写 出 整洁 的 代码 吗 ? 








(D http://en.wikipedia.org/wiki/Software maintenance 
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回答 : 编程 好 比 写作 。 优 秀 的 作家 也 需要 不 断 地 修改 文章 的 语句 和 段落 ,提升 可 理 
解 性 。 即 便 如 此 ， 他们 依然 会 收 到 编辑 审阅 书稿 时 提出 的 许多 问题 。 编写 出 能 提供 期 望 
行为 的 代码 就 已 经 是 一 个 挑战 ， 所 以 第 一 步 是 把 事情 做 对 。 第 二 步 是 改善 代码 ， 让 其 成 
为 易于 维护 的 设计 的 一 部 分 。 

提问 : 我 还 是 不 能 理解 为 什么 在 代码 完成 后 写 一 些 单元 测试 不 能 达成 同样 的 结果 
呢 ? 

回答 : 由 于 人 为 因素 ,这 不 会 发 生 。 首 先 , 一 旦 写 好 代码 ， 大 多 数 程序 员 就 认为 他 
们 完成 了 “真正 ”的 工作 。 他 们 自信 满 满 地 认为 能 写 出 正确 的 代码 ， 经 常 满足 于 一 两 个 
简单 的 手动 测试 ,因此 ,他 们 对 额外 写 一 些 测试 来 证 明 他 们 已 经 知道 的 东西 并 不 感 兴 趣 。 
他 们 也 会 认为 代码 编写 得 足够 好 了 ， 于 是 就 很 少 利 用 测试 整理 代码 。 一般 来 说 ,程序 员 
完成 管理 层 的 任务 时 会 尽量 少 做 。 第 二 , 日 程 安排 压力 通常 起 主导 作用 。 任 何事 (代码 
编写 完成 ) 后 的 事情 只 会 得 到 短期 的 关注 。 

提问 : 就 哪些 代码 需要 测试 这 一 问题 , 难道 不 该 让 程序 员 做 专业 的 判断 吗 ? 有 没有 
代码 简单 到 不 需要 任何 级 别 的 测试 ? 坚持 测试 所 有 东西 是 不 是 有 点 浪费 时 间 ? 

回答 : 大 部 分 系统 不 会 有 太 多 简单 到 不 会 被 破坏 的 代码 ， 所 以 不 会 节省 很 多 测试 时 
间 。 我 同样 不 会 惊讶 于 程序 员 在 看 似 完 美 无 缺 的 系统 中 发 现 缺陷 。 代 码 缺 陷 会 导致 多 种 
方式 的 开销 ,而 且 ， 用 TDD 减 少 缺 陷 也 会 降低 开销 。 在 了 解 系统 如 何 工作 这 个 看 似 简单 
的 问题 上 也 可 以 节省 很 多 时 间 。 

程序 员 在 尝试 为 大 型 、 已 有 的 代码 库 编 写 单元 测试 时 都 会 说 ,这 很 困难 。 主 要 原因 
在 于 ,代码 库 没有 按照 可 测试 的 思维 组 织 ， 结果 导致 为 这 种 系统 写 测试 尤为 困难 。 一般 
的 程序 员 面 对 此 挑战 时 会 选择 放弃 。 

提问 : 我 听 有 些 程序 员 说 ， 实 际 上 只 要 70% 的 代码 有 单元 测试 ， 其 他 部 分 可 以 交 由 
功能 测试 。 

回答 : 提供 快速 反馈 的 测试 不 能 履 盖 系统 中 30% 的 代码 ， 不 会 令 你 如 坐 针 咎 吗 ? 如 
果 系 统 接近 1/3 的 代码 中 确实 有 缺陷 ， 那 么 只 能 在 很 久 后 才能 发 现 它们 。 如 果 需 要 改动 
这 部 分 代码 以 接纳 新 功能 ， 这 会 是 个 相当 慢 长 的 过 程 。 你 需要 增加 单元 测试 ( 对 遗留 代 
码 而 言 困难 得 多 ) 或 使 用 慢 速 的 功能 测试 来 保证 系统 不 被 破坏 。 

提问 : 为 每 个 逻辑 提供 快速 的 测试 是 合理 的 。 但 最 终 会 不 会 产生 更 多 以 测试 形式 存 
在 的 代码 ， 而 你 又 必须 要 维护 它们 ? 

回答 : 不 会 。 大 部 分 系统 的 代码 量 至 少 是 其 应 有 的 两 倍 。 部 分 原因 是 ， 程 序 员 加 入 
新 代码 时 无 法 安全 地 移 除 重复 代码 。 许 多 证 据 表 明 , 单元 测试 的 代码 量 可 能 和 产品 代码 
库 相 当 ， 甚 至 稍微 多 一 点 。 但 是 ， 完 全 使 用 TDD 得 来 的 代码 库 的 代码 量 将 减 半 。 因 此 ， 
代码 量 上 扯 平 了 ， 而 且 还 收获 了 TDD 的 其 他 好 处 。 

提问 : 我 听 说 TDD 不 能 真正 抓 到 很 多 代码 缺陷 。 这 是 不 是 意味 着 完全 在 浪费 时 间 ? 

回答 : TDD 一 开始 就 能 避免 将 代码 缺陷 引入 系统 。 你 总 是 先 写 测试 , 使 其 通过 ， 如 
果 没 能 通过 ， 你 会 在 提交 代码 前 先 修复 。 这 比 先 提交 代码 ， 然 后 在 很 晚 之 后 才 发 现代 码 
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缺陷 要 好 得 多 。 

提问 : 你 让 TDD 听 起 来 像 个 良 方 。 

回答 : TDD 是 个 很 棒 的 工具 ,但 只 是 大 小 刚好 的 工具 箱 中 的 一 个 工具 而 已 。 光 TDD 
是 不 够 的 。 独 立地 验证 小 可 以 将 它们 组 合 在 一 起 达成 想 要 的 功能 。 你 
还 需要 验收 测试 ， 可 能 还 要 和 包 能 测试 、 负 载 测 试 以 及 其 他 形式 的 集成 测试 ， Henn 
有 一 定 程 度 的 探索 性 测试 。 


11.222 XF TDD 的 研究 


有 关 TDD 的 有 效 性 和 成 本 已 经 有 很 多 人 研究。 下面 这 张 表格 总 结 自 George Dinwiddie 的 维基 
面 ” 








T 
= 


























人 主人 7c NK 
Nagappan, N. et al, 2008 TDD 消 除 缺 陷 率 是 40%~90%， 甚 成 本 在 开发 初期 会 多 出 15%~35% 的 时 间 
Braithwaite, K., 2008? TDD 和 代码 复杂 度 成 反比 
Sanchez, J.C., et. al., 2007 cL e S 密度 低 于 行业 标准 。 TDD 或 许 能 减少 代码 复杂 度 随 着 软件 年 限 而 增长 的 
Bhat, T., 2006 TDD 的 使 用 可 以 让 代码 质量 大 幅 提 升 ， 初 始 成 本 至 少 增加 15% 
Siniaalto, M. 2006 有 些 情况 下 ，TDD 会 大 幅 提 升 生产 效 率 ， 大 概 2/13 的 情况 下 会 降低 生产 效率 (但 会 提升 代 

码 质 量 ) 

Erdogmus, H. 2005 写 更 多 测试 的 学 生生 产 效 率 更 高 。 至 少 代码 质量 和 测试 数目 成 线性 关系 











George, B. et al., 2003 测试 驱动 开发 者 生产 高 质量 的 代码 (可 以 通过 18% 或 更 多 的 功能 测试 )， 且 多 用 16% 的 开 
发 时 间 。 事 后 写 测试 的 程序 员 写 的 测试 不 够 充分 


一 个 研究 或 许 不 具有 说 服 力 , 但 是 大 半 的 研究 显示 了 相同 的 结果 , 这 为 以 下 两 点 提供 了 强 有 
力 的 论据 。 
口 TDD 会 开发 出 质量 更 高 的 代码 。 
口 TDD 会 增加 初始 开发 成 本 。 
以 下 几 点 假设 还 没有 相关 的 研究 。 
口 TDD 可 以 降低 长 期 成 本 。 
DO TDD 产 生 的 测试 会 减少 回答 关于 系统 行为 问题 的 时 间 。 


继续 使 用 TDD 的 大 部 分 开发 人 员 并 不 是 基于 这 些 研究 结果 才 选 择 这 一 方法 。 相 反 , 这 是 因 
为 他 们 体会 到 了 其 带 来 的 巨大 益处 , 大 部 分 人 会 告诉 你 使 用 TDD 为 他 们 的 开发 生涯 带 来 了 怎样 
的 影响 。 






































(D http://biblio.gdinwiddie.com/biblio/StudiesOfTestDrivenDevelopment 
© "Measuring the Effective of TDD on Design," http://s3-eu-west-1.amazonaws.com/presentations2012/5 presentation.pdf 
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11.3 不 良 测试 的 死亡 洲 涡 ( 亦 称 为 SCUMmy 周期 ) 


有 时 团队 开始 使 用 TDD 后 , 会 在 一 段 时 期 内 得 到 良好 的 效果 。 而 后 事情 开始 慢 慢 被 忽略 ， 然 
后 快速 被 忽略 ， 最终 决定 放弃 TDD。 是 什么 导致 了 这 个 “讨厌 的 测试 死亡 洲 涡 ”? 怎样 才能 避免 
它 呢 ? 


这 个 问题 不 仅仅 存在 于 TDD 中 。 同 样 也 有 “讨厌 的 敏捷 死亡 洲 涡 ”， 伪 敏捷 的 短 近 代 周期 似 
乎 在 一 段 时 间 内 产生 了 良好 的 效果 。 但 1 年 或 18 个 月 后 ， 团 队 会 对 手头 上 一 堆 混 乱 的 场面 十 分 吃 
惊 。 其 结果 就 是 敏捷 方法 被 抛弃 ， 背负 着 浪费 时 间 的 加 名 。 

Ben Rady 和 Rod Coffin 在 Agile2009 峰 会 上 名 为 “Continuous Testing Evolved”" 的 演讲 中 描述 
了 SCUMmy 周 期 。 缩 写 SCUM 描 述 了 以 下 几 种 导致 退化 的 不 良 测试 的 特征 : 慢 速 (slow )、 令 人 
疑惑 (confusing )、 不 可 靠 (unreliable )、 遗 漏 ( missing )。 下 面 是 一 个 可 能 走向 洲 涡 的 情况 (我 
在 一 些 团 队 中 看 到 过 几 次 此 类 情境 )。 


(1) 国 队 写 的 测试 大 部 分 是 集成 测试 。 这 些 测试 和 不 稳定 或 慢 速 依 赖 紧 密 耦合 ， 如 数据 库 或 
其 他 外 部 API。 虽 然 这 会 导致 更 慢 的 测试 , 但 开始 不 会 觉得 有 很 大 影响 , 因为 仍 可 以 在 1~2 分 钟 内 
运行 完 几 百 个 测试 。( 想 想 “温水 者 青蛙 ”。) 

(2) 测试 变 多 后 带 来 的 问题 超越 心理 承受 底线 。 现 在 运行 完 测试 需要 好 几 分 钟 。 

(3) 开发 人 员 运 行 测试 的 频率 变 低 ， 或 者 只 运行 一 个 测试 子 集 。 同 时 ， 团 队 成 员 发 现 运行 测 
试 的 问题 增多 。 测试 变 得 更 长 , ， 需 要 更 多 的 必要 初始 化 ,一 旦 出 现 问题 ， 则 需要 更 多 的 精力 来 进 
行 理解 和 分 析 。 其 他 问题 也 开始 慢 慢 显现 ， 由 于 依赖 单元 测试 控制 之 外 的 不 稳定 因素 ,测试 会 间 
坎 性 地 失败 。 开 发 人 员 发 现 测 试 经常 上 演 “ 狼 来 了 ”， 这 意味 着 问题 不 是 出 在 产品 系统 自身 ， 而 
是 测试 设计 。 

(4) 开发 人 员 删 掉 测 试 。 对 于 有 问题 的 测试 ， 本 能 反应 就 是 禁用 其 至 删 掉 。 开 发 人 员 发 现 ， 
删 掉 测 试 比 花 费 一 个 小 时 修复 它们 更 容易 。 

(5) 代码 缺陷 开始 变 多 。 剩 下 的 测试 很 可 能 覆盖 不 了 足够 多 的 逻辑 ， 在 防止 代码 缺陷 方面 价 
值 较 小 。( 在 文档 化 价值 方面 也 大 打折 扣 。 ) 

(6) 团队 或 管理 层 质疑 TDD 的 价值 。 团 队 试图 继续 ， 但 很 明显 这 是 徒劳 的 。 

(T) 团队 放弃 TDD。 管 理 层 记 下 这 一 明显 的 失败 。 

团队 该 怎么 办 呢 ? 如 果 早 知 如 此 ， 那 又 何必 当初 呢 ? 

理想 状况 下 , 你 已 经 从 本 书 中 学 到 了 TDD, 它 要 求 限 制 每 个 测试 的 范围 ， 只 测试 一 小 段 独立 
的 逻辑 。 以 这 种 方式 构建 的 系统 不 太 可 能 卷 人 不 良 测 试 的 死亡 流 涡 。 而 且 , 不 是 用 了 TDD 就 能 神 
奇 地 产生 高 质量 的 系统 。 你 和 团队 必须 不 遗 余力 地 去 掉 测 试 和 产品 代码 中 的 不 良 设 计 。 这 同样 要 
求 团队 知道 良好 的 测试 和 代码 是 什么 样子 的 。 














































































































(D http:/agile2009.agilealliance.org/files/session pdfs/ContinuousTestingEvolved.pdf 
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下 面 的 步骤 将 撤回 迈 入 洲 涡 的 步伐 。 如 果 你 积极 地 观察 发 生 的 事情 ,就 可 能 不 会 再 次 在 洲 涡 
中 越 陷 越 深 。 

(1) 团队 写 的 测试 大 部 分 是 集成 测试 。 学 习 怎 样 编写 单元 测试 。 重 读本 书 、 参 加 培训 、 雇 一 
个 教练 、 举 办 Dojos、 更 多 地 审查 、 更 多 地 阅读 ， 等 等 。 同 时 也 要 增加 关于 良好 设计 及 代码 结构 
的 知识 。 

(2) 测试 变 多 后 带 来 的 问题 超越 心理 承受 底线 。 将 测试 分 为 慢 速 和 快速 测试 集 。 设 立 快 测试 
的 标准 。( 在 一 台 开 发 机 上 需要 5 毫秒 或 更 少时 间 ? ) 如 果 团 队 成 员 向 慢 速 测试 集中 加 入 一 个 测 
试 ， 需 要 告知 大 家 。 学 习 重 构 测 试 及 相关 代码 要 做 的 事情 ， 以 便 让 测试 变 快 。 养 成 习惯 ， 增 量 、 
但 经 常 地 尝试 将 慢 速 测试 改进 为 快速 测试 。 

(3) 开发 人 员 运 行 测试 的 频率 变 低 , 或 者 只 运行 一 个 测试 子 集 。 如 果 测 试 运行 超过 慢 速 闵 值 ， 
那么 将 测试 集 标 为 失败 。( 我 最 近 为 客户 成 功 地 改动 Google Test 做 到 了 这 点 。) 这 样 做 会 强化 开发 
团队 认识 到 快速 测试 的 重要 性 。 

(4) 开发 人 员 删 掉 测试 。 监 测 测试 覆盖 率 。 虽 然 建立 覆盖 率 目 标的 价值 有 待 商 榨 ( 参见 11.6 
节 )， 你 还 是 倾向 于 不 断 增 加 或 至 少 有 一 个 稳定 的 覆盖 率 数据 。 不 幸 的 是 ， 用 良好 的 单元 测试 代 
替 不 良 测试 并 获得 同样 的 覆盖 率 可 能 要 费 点 功夫 。 但 在 养 成 正确 的 习惯 前 , 最 好 花 点 时 间 往 对 的 
方向 走 ， 而 非 放弃 。 

(5) 代码 缺陷 开始 变 多 。 对 一 个 代码 缺陷 的 首要 任务 是 写 一 个 测试 。 代 码 缺 陷 为 认识 TDD 实 
践 中 的 不 足 提供 了 机 会 。 对 于 每 个 缺陷 ， 要 坚持 在 修复 问题 前 写 一 个 运行 失败 的 单元 测试 。 

(6) 团队 或 管理 层 质疑 TDD 的 价值 。 精 益 求 精 。 坚 信 TDD 实 践 及 其 他 实践 (如 验收 测试 、 重 
构 和 结对 编程 ) 从 长 远 来 看 主要 致力 于 产 出 高 质量 的 软件 ,而 非 仅 仪 减少 代码 缺陷 。 确保 明 白 这 
些 实践 如 何以 及 为 什么 和 质量 挂钩 , 同时 确保 团队 成 员 以 一 种 有 助 于 达成 高 质量 目标 的 方式 践 行 
它们 。 缺 乏 对 质量 的 关注 将 导致 系统 开发 失败 “不 良 测 试 的 死亡 流 涡 ”更 不 可 侥 恕 。 

(7) 团队 放弃 TDD。 不 要 坐 以 待 毙 ! 管理 层 很 少 会 容忍 再 次 迈 向 他 们 认为 必定 失败 的 步伐 。 

和 其 他 事情 一 样 ,你 可 能 会 因 不 当地 使 用 TDD 而 导致 失败 。 但 也 有 可 能 成 功 , 并 且 是 大 获 成 
功 , 否则 的 话 , 我 也 不 会 大 动 干戈 地 写 下 本 书 。 由 于 未 能 正确 地 坚持 一 项 技术 而 认为 它 本 身 不 好 ， 
可 是 非常 不 好 的 ! 
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你 写 的 测试 和 产品 代码 等 同 于 高 郧 的 投资 。 理想 情况 下 , 你 会 假设 所 有 的 开发 者 都 经 历 了 必 
要 的 培训 , 更 重要 的 是 , 要 有 高 效 地 编写 高 质量 代码 的 意愿 。 但 只 要 看 一 下 任何 现存 的 系统 就 知 
道 并 不 是 那么 回 事 。 
在 本 书 中 , 我 已 经 尝试 让 大 部 分 系统 一 团 糟 , 这 是 因为 程序 员 没 有 有 效 保障 代码 不 会 退化 的 
机 制 (如 TDD )。 当 然 也 有 很 多 其 他 原因 。 
口 缺乏 教育 : 太 多 的 程序 员 不 理解 核心 的 设计 原则 和 良好 的 编程 结构 。 其 中 一 些 人 认为 他 1 
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们 知道 的 够 多 了 ， 不 承认 还 有 更 多 的 东西 要 学 。 

O 缺乏 担忧 : 太 多 的 程序 员 不 在 乎 编写 出 难 懂 的 代码 。 或 者 他 们 会 为 此 辩护 ， 说 系统 中 已 

经 充满 了 不 良 代码 。 

O 时 间 压 力 : 你 听 到 过 多 少 次 “发 布 吧 一 一 我 们 没有 时 间 关 心 质量 了 ”? 

口 缺乏 审查 : 大 多 数 是 因为 一 个 捣蛋 的 程序 员 往 代码 库 中 加 入 了 具有 严重 破坏 性 的 代码 。 
有 时 ， 这 个 程序 员 是 一 个 身价 昂贵 的 短期 顾问 。 有 时 ， 在 发 现 这 些 糟糕 代码 前 ， 作 者 就 
已 经 不 见 踪 影 了 ， 只 剩 下 你 独自 面 对 这 不 一 致 且 难以 维护 的 代码 。 

口 缺乏 合作 : 在 多 于 一 个 开发 者 的 团队 或 一 个 大 小 合理 的 代码 库 中 ， 编 码 风 格 的 不 同和 代 
码 质量 的 好 坏 会 很 快 展现 出 来 。 在 缺乏 解释 的 情况 下 ， 理 解 别 人 写 的 一 段 代 码 可 能 非常 
困难 ， 其 他 开发 者 或 许 会 编写 一 个 解决 方案 来 处 理 已 经 解决 了 的 问题 。 单 个 程序 员 可 能 
在 没有 寻求 别人 意见 的 情况 下 编写 出 不 够 优化 的 代码 。 







































































11.4.4 结对 原则 


结对 编程 技术 的 意义 在 于 , 通过 提供 持续 审查 、 合 作 及 来 自 队友 的 压力 来 帮助 开发 程序 。 下 
面 总 结 了 结对 编程 是 怎样 工作 的 。 
口 两 个 程序 员 积 极地 共同 开发 一 个 解决 方案 。 
O 程序 员 通 常 肩 并 肩 地 坐 在 一 起 〈 虽 然 包括 远 程 结 对 在 内 的 其 他 方式 也 是 有 可 能 的 ) 
O 在 任意 给 定时 刻 ， 每 个 人 扮演 以 下 角色 之 一 : 驱动 ， 即 积极 地 编写 解决 方案 ; 领航 ， 即 
提供 审查 和 策略 指导 。 结 对 不 是 一 个 人 做 ， 另 一 个 人 坐 在 后 面 看 。 
口 结对 的 程序 员 要 在 结对 期 间 经 常 互 换 角色 ， 可 以 在 测试 失败 或 成 功 时 互 换 。 
口 结对 是 暂时 的 ， 每 90 分 钟 就 重新 结对 。 轮 流 结对 的 主要 目的 是 团队 内 部 间 可 以 增加 知识 ， 

相应 地 降低 风险 。 


和 TDD 很 像 ， 结 对 编程 的 相关 研究 "表明 ， 代 码 质量 提升 的 同时 开发 初期 成 本 也 会 增加 。 你 
应 该 想起 “人 多 智 广 ”这 名 格言 了 。 可 能 和 你 开始 想 的 一 样 ， 成 本 不 会 成 倍增 长 。 积 极 的 代码 审 
查 带 来 的 高 质量 是 一 个 原因 。 来 自 队友 的 压力 和 沟通 程度 的 提高 、 协 作 以 及 教导 也 是 带 来 更 低 成 
本 的 原因 。 其 他 好 处 也 很 多 ， 例 如， 降低 了 风险 、 提 升 了 灵活 度 ”。 


































































































11.4.2 ”结对 编程 与 测试 驱动 开发 


TDD 和 结对 编程 是 天 作 之 合 。 如 果 有 一 个 支持 体制 的 话 , 那么 学 习 TDD 会 变 得 非常 容易 。 即 
使 队友 不 施加 任何 压力 , 开发 者 也 很 可 能 丢弃 旧 的 、 非 TDD 的 习惯 。 同 有 经 验 的 测试 驱动 开发 者 





























(D 参见 Dybi, T. et. al. “Are Two Heads Better Than One? On the Effectiveness of Pair Programming," at http://dl.acm.org/ 
citation.cfm?id-1309094, 这 总 结 了 一 些 关于 结对 编程 的 研究 。 
© 参见 http://pragprog.com/magazines/2011-07/pair-programming-benefits 来 了 解 更 多 的 潜在 好 处 。 
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并 肩 作战 会 让 习 得 TDD 的 过 程 事 半 功 倍 。 交 换 伙伴 有 助 于 用 心地 写 好 测试 。 

TDD 周 期 也 为 结对 期 间 的 角色 变换 提供 了 天 然 的 切换 点 。 许 多 程序 员 使 用 乒乓 结对 。 第 一 个 
程序 员 一 直 写 测试 代码 , 直到 失败 , 然后 将 键盘 交 给 第 二 个 程序 员 。 第 二 个 程序 员 编写 产品 代码 ， 
证 测试 通过 ,然后 接着 写 测 试 的 其 余部 分 或 下 一 个 测试 。 一 旦 测试 通过 ， 队 友 间 可 以 在 各 类 重 构 
过 程 中 互 换 角 色 。 

队友 间 会 时 不 时 地 讨论 测试 方向 ,特别 是 在 他 们 了 解 彼此 偏好 风格 的 情况 下 ,一 般 的 经 验 是 ， 
在 队友 拿 到 键盘 并 演示 这 些 意图 前 ， 争 论 不 要 超过 5 分 钟 。 通 常情 况 下 ， 这 样 得 来 的 测试 方向 胜 
于 经 过 讨论 得 来 的 。 
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11.4.3 角色 切换 


如 前 文 所 说 ， 结 对 是 暂时 的 。 然 而 ， 比 较 自 然 的 倾向 是 允许 结对 时 间 足 够 长 ， 以 便 在 这 期 间 
能 完成 一 个 任务 或 者 整个 功能 。 

当然 ， 伙 伴 交换 会 带 来 上 下 文 切换 的 开销 。 如 果 你 新 加 入 一 个 结对 ( 新 手 )， 必 须 放 弃 对 刚 
刚 要 解决 的 问题 的 深入 思考 。( 我 将 你 要 结对 的 程序 员 称 之 为 内 行 。) 对 大 多 数 人 而 言 , 这 没什么 
大 不 了 的 , 打 断 5 或 10 分 钟 也 不 算 什么 。 但 随后 要 面临 更 难 跟 上 新 问题 的 挑战 。 根据 问题 的 难度 ， 
可 能 只 需要 几 分钟 ， 但 也 可 能 需要 来 自 内 行 详细 且 耗 时 的 解释 。 

如 果 采 用 TDD, 关注 点 就 不 同 了 。 相 比 于 来 自 内 行 的 详细 解释 ,你 会 更 专注 于 当前 失败 的 测 
试 。( 如 果 没 有 的 话 , 那 就 在 内 行 添加 时 边 听 边 看 好 了 。) 此 时 的 目标 是 阅读 测试 名 称 并 确保 其 是 
合理 的 。 然 后 可 以 阅读 测试 来 帮助 理解 当前 的 编程 任务 。 

只 关注 单个 测试 , 特别 是 编写 良好 、 目的 精确 的 单元 测试 , 能 够 让 你 更 容易 地 开始 作出 贡献 。 
你 不 需要 了 人 解 所 有 细节 。 相 比 于 提前 列 出 详细 元 长 的 介绍 ， 内 行 会 慢 慢 地 指导 你 前 进 。 

团队 在 任务 间 切 换 得 越 多 , 就 变 得 越 容易 ， 特 别 是 在 一 个 小 团队 里 。 但 为 什么 不 在 任务 完成 
前 防止 切换 呢 ? 

WIE, 结对 的 一 个 关键 目的 是 代码 审查 。 通 常 而 言 ， 人 多 智 广 , 但 结对 依然 有 可 能 导致 不 良 
的 生产 力 。 这 很 可 能 会 发 生 在 结对 深入 解决 方案 , 并 到 达 一 个 他 们 可 以 说 服 自己 只 有 一 个 正确 答 
案 的 点 时 。 此 时 ， 如 果 一 个 没有 深入 解决 方案 的 局 外 人 和 结对 分 享 一 些 思 考 ， 有 利于 从 全 新 的 视 
角 切 和 人 从 而 避免 不 良 的 解决 方案 。 

此 外 , 加 强 结对 互 换 会 提升 新 加 入 的 队友 熟悉 特定 部 分 代码 的 可 能 性 。 在 大 小 适中 的 系统 中 
定期 地 结对 互 换 ， 可 以 让 每 个 人 最 终了 解 系统 的 全 部 。 

如 果 团 队 努力 坚持 的 话 , 结对 互 换 的 另 一 个 重要 益处 是 代码 质量 的 提升 。 因 为 质量 更 好 的 代 
码 会 减少 新 人 理解 代码 的 时 间 ,， 这 有 助 于 降低 上 下 文 切换 的 成 本 。 必 须要 修改 不 清晰 的 代码 。 结 
对 应 该 迅速 知道 为 了 清晰 而 持续 重 构 可 以 节省 时 间 ， 对 测试 更 是 如 此 。 





















































264 $113 发 展 和 维持 测试 驱动 开发 











结对 互 换 体现 了 增加 的 初期 成 本 和 长 期 收益 间 的 权衡 , 和 结对 编程 自身 、TDD 以 及 许多 敏捷 
软件 开发 特点 非常 类 似 。 上 下 文 切换 当然 会 带 来 短期 的 痛苦 , 但 随 着 时 间 的 推移 ,你 能 够 学 习 到 
怎样 减轻 痛苦 。 然 而 ,在 满 是 孤立 开发 者 的 团队 中 , 由 少量 代码 审查 及 没有 分 享 知 识 造成 的 痛苦 
会 伴随 时 间 一 直 持续 下 去 。 






































11.5 Kata 和 Dojo 


除了 持续 地 学 习 新 知识 , 成 功 的 专业 人 士 会 定期 锻炼 他 们 的 手艺 。 音 乐 家 将 音阶 作为 热身 训 
练 、 整 形 外 科 医 生 用 尸体 做 练习 、 运 动员 做 一 些 日 常 操 练 和 训练 比赛 、 演说 家 会 对 着 镜子 做 热身 、 
武术 家 练习 Kata 一 一 精心 组 织 的 动作 模式 。 

在 这 些 练习 时 有 段 里 , 练习 者 会 重复 其 职业 生涯 初期 习 得 的 常见 和 基本 的 要 素 。 这些 操 练 有 助 
于 加 深 基本 技能 。 同 时 ,练习 者 在 表演 或 比赛 前 也 会 用 这 些 做 热身 。 在 比赛 期 间 ， 经 验 丰 富 的 人 
会 尽 可 能 地 赁 靠 “ 肌 肉 记 忆 ” 处 理 基 本 的 动作 。 这 样 有 益 于 提升 他 们 的 思考 能 力 ， 从 而 对 其 所 处 
的 环境 作出 更 好 的 反应 。 

此 外 , 对 基本 动作 的 掌握 是 进一步 成 长 和 探索 的 基本 功 。 更 加 复杂 和 有 效 的 招式 常常 是 基本 
招式 的 创新 变种 。 高 级 专业 人 士 有 时 甚至 会 发 现 , 他 们 可 以 忘掉 基本 的 规则 。 他 们 对 基本 招式 的 
精深 把 控 ， 使 其 意识 到 并 接受 忘却 它们 带 来 的 成 本 。?” 

许多 开发 者 将 武术 中 Kata 的 概念 应 用 到 TDD 中 。 两 者 的 理念 类 似 : 测试 驱动 开发 出 对 应 简单 
编程 问题 的 解决 方案 。 不 断 重复 这 个 训练 ， 直 到 可 以 展示 通 往 解决 方案 的 理想 路 径 ， 在 这 个 路 径 
上 没有 多 余 的 步骤。Dave Thomas 在 他 的 个 人 站 点 上 提供 了 一 些 示 例 问 题 ( http://codekata. 


pragprog.com )。 





































































































11.5.1 在 测试 驱动 开发 中 应 用 Kata 


Kata 对 于 练习 TDD 也 奏效 吗 ? 为 了 构建 软件 ， 在 任何 特定 时 刻 你 都 要 和 大 量 的 工具 打交道 。 
你 的 双手 要 用 键盘 编写 代码 ; 你 要 同一 个 编辑 器 交互 ， 它 提供 了 完成 任务 的 许多 方法 ; 你 也 要 使 
用 一 门 语言 及 一 些 程序 库 ( 包括 一 个 测试 框架 ), 同样 ,它们 也 提供 了 达成 解决 方案 的 无 数 方法 。 
最 终 ， 你 要 思考 很 多 东西 。 虽然 打造 解决 方案 的 过 程 貌似 是 唯一 、 不 可 重复 的 , 但 在 软件 开发 中 
依然 有 许多 重复 性 的 主题 ( 模式 )。 


越 多 地 练习 这 些 要 素 ， 就 越 能 更 好 地 掌握 它们 。 最 难 的 部 分 无 疑 是 思考 ,但 依然 可 以 通过 解 
决 编程 问题 来 更 好 地 思考 。 


从 哪里 开始 呢 ? 找到 一 个 感 兴趣 的 Kata， 或 许 就 是 之 前 所 演示 的 那个 。 对 于 第 一 个 Kata， 最 


























































































































CD 在 武术 中 有 和 名 话 一 一 无 招 胜 有 招 。 其 意思 是 基本 的 招式 已 经 固化 为 本 能 ， 习 武者 会 本 能 地 做 出 一 些 应 对 招式 ， 而 
不 需要 经 过 大 脑 思考 。 忘 掉 基本 招式 反而 使 反应 更 快 ， 因 为 思考 的 成 本 更 高 。 译 者 注 
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好 找 一 个 能 在 一 个 小 时 内 完成 的 小 问题 。 记 下 时 间 ,， 然后 开始 测试 驱动 开发 解决 方案 。 如 果 被 问 
题 卡 住 ， 要 甘愿 后 退 一 点 点 。 最 后 记录 下 完成 解决 方案 所 需要 的 时 间 。 

如 果 你 绝望 地 深 陷 泥 潭 ， 那 么 就 彻底 放弃 ， 重 新 尝试 ， 必 要 时 寻求 帮助 。( 你 将 知道 是 否 需 
要 选择 男 外 的 Kata 作 为 第 一 次 练习 。 ) 

审查 你 的 解决 方案 , 思考 怎么 得 出 这 个 解决 方案 的 。 青 一 次 练习 这 个 Kata， 最 好 是 马上 或 者 
在 一 段 合理 的 时 间 内 ， 以 便 记 住 刚 学 习 到 的 东西 。 不 要 去 记忆 ， 而 是 要 思考 走 好 下 一 步 。 与 第 一 
次 练习 花费 的 时 间 进 行 对 比 。 


时 不 时 地 重复 这 个 Kata， 大 概 一 周 1~3 次 。 找 出 需要 改进 和 改善 的 地 方 。 例 如 ， 寻 求 更 好 的 
API 或 语言 结构 ， 并 使 用 更 好 的 编辑 器 快捷 键 以 减少 敲 键盘 的 次 数 。 你 将 在 某 个 点 接近 理想 的 解 
决 方案 ,并 具备 以 最 少 的 步骤 和 错误 得 出 此 方案 的 能 力 。 现 在 它 成 了 你 热身 练习 包 中 的 一 个 工具 。 

要 想 提 高 测试 驱动 解决 问题 的 能 力 , 需要 丰富 热身 练习 包 。 解 决 不 同类 型 的 问题 能 够 教会 你 
不 同 的 技巧 ， 有 助 于 获得 更 重要 的 洞察 力 。 

附录 B 中 包含 了 一 个 简单 的 出 发 点 一 一 罗马 转换 器 练习 ， 在 这 个 练习 中 ， 你 要 测试 驱动 开发 
出 一 个 算法 ,用 来 将 阿拉 伯 数 字 转 换 为 对 应 的 罗马 数字 。 你 也 可 以 尝试 来 自 本 书 的 其 他 练习 ， 例 
如 ， 将 Soundex 作 为 你 的 第 一 个 Kata。 表 1 中 描述 了 许多 有 用 的 Kata 资 源 。 










































































表 1 Kata 资源 

















站 点 名 网 mH 描 Ë 

CodeKata http://codekata.prag-prog.com Dave Thomas 最 初 的 Kata 站 点 

Craftmanship Katalogue http://craftsman-ship.sv.cmu.edu/katas 各 种 Kata 的 评分 和 资源 

Coders Dojo http://codersdojo.org 允许 尝试 并 分 享 Kata (Ruby 语 言 版 本 ) 

Software Craftmanship Code Kata http://katas.softwarecrafts-manship.org 包含 各 式 Kata 的 视频 

TDD Problems https://sites.google.com/site/tddproblems/ ”主要 为 演示 测试 驱动 而 设计 ， 但 也 可 以 
用 作 Kata 

cyber-dojo http://www.cyber-dojo.com 一 个 在 线 的 Dojo， 人 允许 在 浏览 器 中 编码 
和 测试 

11.5.2 Dojo 
Kata 是 典型 的 单 人 训练 (虽然 也 可 很 好 地 用 于 结对 训练 )。 你 可 以 随时 练习 ， 并 在 5 分 钟 或 





15 分 钟 后 停止 。 在 训练 场 中 ,以 团队 的 形式 练习 Kata 可 以 更 进一步 地 掌握 TDD。 类 似 于 武术 中 的 
Dojo， 测 试 驱动 开发 Dojo 是 群 组 训练 ， 其 中 有 一 些 级 别 的 仪式 和 结构 。 


对 于 典型 的 Dojo， 将 时 间 定 为 60~90 分 钟 ， 找 一 个 有 投影 的 房间 ， 让 每 个 人 都 能 看 到 屏幕 。 
为 了 让 团队 对 Dojo 的 概念 有 所 认识 , 你 的 第 一 次 Dojo 练 习 可 能 需要 一 个 或 一 对 演示 人 员 , 由 他 们 
示范 怎样 对 一 个 Kata 演 绎 出 最 终 的 解决 方案 ， 且 他 们 事先 已 经 完成 过 这 个 Kata。 演 示人 员 的 工作 
是 确保 所 有 人 理解 他 们 在 进行 下 一 步 前 的 编程 选择 。 
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对 之 后 的 Dojo 来 说 ，randori-style 更 具 娱 乐 性 和 带 入 性 。 有 很 多 各 式 各 样 的 randori dojo 结 构 ; 
下 面 是 一 个 在 Coding Dojo wiki ( http://codingdojo.org ) 上 的 描述 。 


口 开始 进行 Dojo 时 ， 由 结对 处 理 整个 组 选择 的 问题 。 
a 结对 中 的 程序 员 在 开发 者 和 指引 者 间 频 繁 切换 角色 ， 可 以 使 用 乒乓 结对 。 
O 这 个 结对 有 大 概 5~15 分 钟 的 时 间 限 制 ， 用 来 推进 解决 方案 。 开 发 时 ， 他 们 应 该 描述 正在 
做 的 工作 。 
a 到 限制 时 间 时 ， 绪 对 中 的 一 个 成 员 (通常 是 开发 者 ) 被 换 出 ， 由 观众 成 员 代替 。 所 有 的 
Dojo 参 与 者 在 整个 过 程 中 至 少 被 换 入 结对 一 次 。 
口 观众 成 员 可 以 适当 地 提出 建议 。 

你 可 以 选择 一 个 老师 ， 通 过 提问 〈 但 不 给 出 答案 ) 的 方式 来 给 你 提供 指导 建议 , 并 在 其 他 方 
面 做 些 工 作 来 辅助 Dojo 训 练 。 


如 果 Kata 进 行 超过 半 个 小 时 ， 不 妨 中 途 休息 5 分 钟 。 结 束 时 做 一 个 简要 的 回顾 : 讨论 整个 过 
程 中 做 的 好 的 地 方 ， 决定 下 一 次 要 采用 的 不 同方 式 。 

Randori Dojo 为 团队 的 每 个 人 提供 了 参与 的 机 会 。 当 团队 要 处 理 新 问题 或 某 个 开发 者 要 演示 
他 认为 更 有 效 的 解决 方案 时 ， 你 或 许可 以 切换 回 演示 风格 。 

Dojo 的 要 点 在 于 合作 与 分 享 。 团队 可 以 更 好 地 理解 别人 是 怎样 解决 问题 的 , 你 也 会 在 这 个 过 
程 中 学 到 许多 新 点 子 。 



























































11.0 ”有 效 地 使 用 代码 覆盖 率 统计 


代码 履 盖 率 单元 测试 覆盖 的 代码 行 比 例 是 一 个 新 的 “代码 行 ”统计 方法 ,肯定 会 被 
许多 懒惰 的 经 理 滥 用 。 对 此 统计 方法 最 幼稚 的 理解 是 : 100% 意 味 着 代码 被 全 面 覆 盖 ， 而 0% 表 示 
你 甚至 没 做 过 这 方面 的 努力 。 你 可 以 找到 很 多 C++ 代码 覆盖 率 工 具 , 大 部 分 是 收费 的 。COVTOOL 
( http://covtool.sourceforge.net ) 是 一 个 开源 的 测试 覆盖 率 工 具 。 


好 的 覆盖 率 工 具 也 会 “注释 ”代码 , 在 运行 测试 时 可 以 标明 哪些 特定 的 代码 行 会 被 执行 。 度 
量 覆 盖 率 的 真正 价值 在 于 ， 知 道 哪 些 代 码 没有 被 覆盖 有 助 于 决定 哪里 需要 添加 测试 。 

如 果 一 直 遵 循 简单 的 TDD 周 期 来 开发 代码 , 代码 履 盖 率 将 逼近 100%。( 代码 覆盖 率 或 许 永远 
不 会 到 达 100%， 这 受 限 于 工具 自身 ， 以 及 在 识别 特定 代码 怎样 被 使 用 方面 的 功能 。 这 没什么 问 
题 。) 你 已 经 知道 了 这 个 情况 一 一 如 果 只 在 测试 失败 的 情况 下 写 代码 ， 并 且 所 写 代 码 量 不 多 于 让 
失败 测试 通过 ， 从 定义 来 看 ， 就 达到 了 100% 的 覆盖 率 。 就 个 人 而 言 ， 我 不 会 因此 而 担忧 代码 测 
试 工具 。 但 如 果 你 坚持 先 写 测试 , 或 者 倾向 写 多 于 让 测试 通过 的 代码 量 , 代码 覆盖 率 工具 能 够 提 
供 有 价值 的 反馈 。 


系统 范围 的 平均 覆盖 率 低 于 90% 的 话 , 说 明代 码 库 不 是 (不 完全 或 根本 没有 ) 用 TDD 开 发 的 ， 
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仅 此 而 已 。 履 盖 率 达到 90% 或 更 多 , 传达 的 信息 也 很 有 限 一 一 通常 意味 着 代码 库 是 用 TDD 构 建 的 ， 
但 使 用 集成 测试 覆盖 大 量 代 码 也 是 有 可 能 的 。 更 典型 的 是 , 未 用 TDD 构 建 的 系统 的 整体 覆盖 率 非 
常 低 (以 我 的 经 验 ， 很 少 高 于 70% )。 集 成 测试 很 难 覆 盖 每 个 未 分支， 同样 ， 在 代码 编写 完 后 很 
难 编写 全 面 的 单元 测试 。 

用 TDD 编 写 精准 的 单元 测试 也 有 可 能 达到 90% 以 上 的 覆盖 率 , 但 创建 的 测试 却 难以 维护 。 换 
言 之 ， 高 覆盖 率 可 能 看 上 去 很 好 ， 但 却 没有 说 明 所 有 的 信息 。 

永远 不 要 将 代码 覆盖 率 作 为 目标 。 坚决 主张 高 覆盖 率 的 经 理会 得 到 诉求 的 答案 
率 数据 ， 其 他 用 途 寥寥 无 儿 。 


11.7 ”持续 集成 


你 在 职业 生涯 中 听 过 多 少 次 “在 我 的 机 器 上 是 工作 的 ”这 样 的 话 ? 或 者 你 自己 也 说 过 ?除非 
你 的 代码 集成 了 其 他 的 产品 代码 , 并 且 在 基准 机 器 (这 台 机 右上 的 环境 和 生产 环境 类 似 ) 上 运行 
了 所 有 的 测试 ， 否 则 你 不 会 真正 得 知 它 是 否 工 作 。( 直到 在 真正 的 客户 那 运行 成 功 了 ， 你 才能 
道 它 真 的 可 以 工作 ) 

持续 集成 ( continuous integration, CI ) 服务 器 的 工作 是 检测 源码 仓库 ， 在 提交 代码 时 开启 构 
建 流 程 。 一 旦 构建 完成 ， 持 续集 成 服务 器 通知 所 有 对 此 事件 感 兴趣 的 人 ,保留 构建 输出 以 便 日 后 
查看 o 

构建 脚本 应 该 编译 、 链 接 、 部 署 、 运 行 单元 测试 及 其 他 测试 ， 做 任何 你 认为 必要 的 事情 ,证 
明 系 统 可 以 发 布 (至少 接近 发 布 )。 一 些 能 力 很 强 的 团队 有 足够 的 信心 ， 认 为 他 们 的 构建 已 经 演 
化 到 持续 发 布 的 级 别 一 一 每 次 构建 成 功 就 可 以 部 署 到 生产 环境 。 

持续 集成 的 构建 可 能 会 花 一 些 时 间 , 但 也 还 好 。 拥 有 持续 集成 服务 器 可 以 让 你 持续 工作 , 一 
且 它 发 现 问题 ， 你 就 能 及 时 知道 。 但 要 小 心 ， 不 要 因为 有 了 工具 就 满足 于 总 体 构建 时 间 。 缓 慢 、 
耗 时 不 断 变 长 的 构建 过 程 很 快 会 成 为 问题 。 一 天 得 到 几 次 反馈 是 必要 的 。 

在 TDD 环 境 中 ,持续 集成 服务 器 是 基础 工具 。 没 有 理由 不 拥有 一 个 。 测 试 (包括 所 有 的 非 单 
元 测试 ) 是 代表 整体 系统 健康 的 最 好 晴雨 表 。 提 交代 码 时 ， 你 想 要 知道 代码 给 系统 带 来 的 价值 ， 
以 及 代码 不 会 破坏 最 新 代码 库 中 的 任何 功能 。 

确保 你 的 团队 对 基于 持续 集成 的 所 有 流程 意见 一 致 (参见 11.8 节 )。 你 应 该 知道 提交 代码 后 
会 发 生 什么 ， 也 应 该 知道 持续 集成 服务 器 报告 构建 错误 时 会 发 生 什么 。 

有 许多 持续 集成 服务 器 供 你 使 用 。 知 名 的 工具 包括 : Jenkins 、buildbot 、CruiseControl 和 
TeamCity。 要 根据 环境 及 构建 脚本 选择 最 适合 的 。 在 StackOverflow 上 可 以 找到 有 关 合 适 的 持续 集 
成 服务 器 的 讨论 "。 





















































高 的 覆盖 










































































































































































(D 参见 http:/stackoverflow.com/questions/145586/what-continuous-integration-tool-is-best-for-a-c-project。 
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11.8 ”为 团队 制定 测试 驱动 开发 标准 











要 确保 团队 在 几 个 简单 的 标准 下 使 用 TDD 方 法 。 不 要 让 这 些 标准 成 为 起 步 的 绊脚石 。 正 如 敏 


捷 和 TDD 的 其 他 东西 一 样 ， 其 目标 是 采取 小 步伐 ， 然 后 在 前 行 的 过 程 中 持续 改善 。 
下 面 是 需要 认同 的 一 些 关键 





iini 





EI. 





口 单元 测试 工具 ( 如 Google Test, CppUTest, CppUnit )。 随 着 时 间 的 推移 ， 你 可 以 使 用 以 后 
出 现 的 更 好 的 工具 。 那 时 ， 增 量 地 迁移 是 可 以 的 。 但 就 目前 而 言 ， 如 果 没 有 更 好 的 理由 























不 使 用 它 ， 那 么 你 应 该 找到 最 适合 团队 的 单元 测试 工具 ， 并 坚持 使 用 。 
口 其 他 工具 ， 包 括 模拟 框架 和 代码 覆盖 率 工 具 。 




















口 集成 标准 。 在 集成 代码 进入 源 代码 管理 系统 前 ， 团 队 成 员 应 该 对 采取 的 测试 级 别 达成 共 


识 。 理 想 情况 下 ， 开 发 人 员 应 该 运行 所 有 的 单元 测试 ， 前 提 是 它 不 会 成 为 频繁 集成 的 障 








但 (因为 遗留 系统 产生 的 问题 )。 如 果 有 测试 失败 ， 那 么 要 杜绝 提交 代码 。 





























口 失败 流程 。 当 构建 失败 ， 应 该 发 生 什么 ， 哪些 人 要 参与 进来 ? 


因 ， 代 码 提交 者 应 该 提供 解释 性 注释 。 




















面 犯 教条 主义 。 准 确 性 和 可 读 性 是 重要 的 因素 。 

O 测试 结构 。 遵 从 了 AAA 四 ? 怎样 命名 fixture 的 ? 测试 的 物理 布局 是 怎样 的 
织 的 角度 出 发 ) ? 
O 断言 格式 。 是 Hamerest， 还 是 其 他 的 ? 断言 的 注释 可 行 吗 ? 




















在 会 议 中 花 一 个 小 时 讨论 代码 库 的 标准 、 记 录 遇 到 的 问题 、 达 成 共识 ,然后 继续 下 去 。 如 果 











口 禁用 、 注 释 掉 测试 。 一 般 来 说 ， 坚 持 不 要 将 这 样 的 改动 提交 进 代 码 库 。 如 果 有 充足 的 原 


a 测试 运行 标准 。 测 试 怎么 样 算是 慢 的 ? 测试 可 以 向 控制 台 输 出 信息 吗 (最 好 不 要 ) ? 





口 测试 名 称 格式 。DoesSomethingWhenSomeContextExists 是 个 好 的 出 发 点 , 但 要 避免 在 此 方 


从 包 和 文件 组 





认识 到 标准 与 代码 冲突 ， 那 么 就 修改 标准 。 拥 有 标准 虽 好 ， 但 绝 不 要 让 它 成 为 前 进 的 拦路 石 。 


11.9 ”保持 与 社区 同步 





TDD 是 永 无 止境 的 探索 之 旅 ,。 不 断 有 新 的 、 更 好 的 想法 来 更 好 地 实践 TDD。 使 用 TDD 这 数 十 
年 来 , 我 个 人 不 断 地 汲取 关于 它 的 新 主意 。 我 在 2000 年 写 下 的 测试 和 代码 让 我 感到 失望 ,甚至 昨 
天 写 的 测试 和 代码 同样 让 我 失望 。 这 没关系 ， 因 为 TDD 周 期 是 构建 在 持续 改善 的 理念 之 上 。 














本 广 将 提供 一 些 主意 ， 让 你 可 以 去 TDD 社 区 找到 新 的 、 有 趣 的 东西 。 


11.9.1 阅读 测试 


学 会 怎样 阅读 代码 是 值得 获取 的 技能 。 更 好 的 阅读 代码 方法 是 先 观察 描述 其 行为 的 测试 。 


11.10 结束语 209 








开源 项 目 为 了 解 别人 使 月 





TDD 的 方式 提供 了 捷径 。 你 会 发 现 大 家 的 风格 多 种 多 样 , 毫 无 疑问 ， 





你 已 经 可 以 识别 阅读 测试 中 不 好 的 实践 。 
不 要 只 局 限于 阅读 C++ 测 试 。TDD 的 核心 原则 同样 适用 于 其 他 编程 语言 。 





11.9.2 ”博客 与 论坛 
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站 点 名 








URL 














参与 讨论 ! 下 述 表格 给 出 了 几 个 经 常 或 一 直 讨 论 TDD 的 活跃 论坛 和 博客 : 


谁 /什么 





Test-Driven Development 
Yahoo!Group 


Extreme Programming Yahoo!Group 


LinkedIn Test-Driven Development 
Group 


Agile Otter Blog 


James Grenning's Blog 


Michael Feathers 


Uncle Bob 


Coding Is Like Cooking 


Sustainable Test-Driven 


Developement 
Jeff's Blog 
11.10 RE 


http://tech.groups.yahoo.com/group/ 
testdrivendevelopment/ 


http://tech.groups.yahoo.com/group/ 
extremeprogramming/ 


http://www.linkedin.com/groups/Test- 
Driven-Develop- ment-155678 


http://agileotter.blogspot.com/ 


http://www.renaissancesoft- 
ware.net/blog/ 


http://michaelfeathers.type-pad.com/ 
michael feath-ers blog/ 
http://blog.8thlight.com/uncle-bob/ 


archive.html 


http://emily-bache.blogspot.com/ 


http://www.sustainablet-dd.com/ 


http://langrsoft.com/jeff/ 


基于 邮件 的 论坛 





基于 邮件 的 论坛 





基于 网 页 的 论坛 


Tim Ottinger, Agile In a Flash 的 合 著 者 
(Agile in a Flash: Speed-Learning Agile 
Software Development[LO11] ) 

Test-Driven Development in Embedded C 
HJ A # # ( Embedded Test Driven 
Development Cycle[Gre07] ) 


《修改 代码 的 艺术 》 的 作者 (《 修 改 代 码 
的 艺术 》) 
Clean Code 的 作者 (Clean Code: A Hand- 


book of Agile Software Craftsmanship 
[Mar08] ) 


Emily Bache, The Coding Dojo Handbook 
的 作者 (The Coding Dojo Handbook 
[Bac12]) 


Scott Bain 和 Amir Kolsky 


我 本 人 的 


WE! 你 已 经 学 习 了 TDD 的 大 量 知识 ,以 及 它 可 以 怎样 让 你 和 你 的 团队 受益 。 在 本 章 中 , 你 
学 到 了 让 个 人 和 团队 保持 热情 不 减 的 方法 。 




















TDD 的 周期 很 简单 : 制定 、 构 建 、 改 善 。 本 书 已 经 提供 了 实践 TDD 的 规范 。 必 须 通过 持续 地 
使 用 和 练习 来 打造 你 自己 的 TDD 知 识 库 。 最 重要 的 是 , 你 和 你 的 团队 要 在 本 书 的 基础 上 不 断 地 进 








取 和 改善 。 























比较 单元 测试 工具 








A1.1 开场 白 


本 书 中 的 例子 用 到 了 Google Test, Google Mock 和 CppUTest。 你 可 能 已 经 使 用 了 其 他 的 单元 
测试 工具 , 或 者 你 的 开发 环境 需要 男 一 种 不 同 的 工具 。 在 本 章 中 ,你 将 快速 浏览 一 些 特性 以 考虑 
为 TDD 选 择 合适 的 单元 测试 工具 。 




















A1.2 测试 驱动 开发 单元 测试 工具 的 特性 


几乎 任何 你 关心 的 工具 都 能 满足 TDD 的 需求 。 有 些 工 具 使 其 变 得 更 简单 , 有 些 则 使 TDD 变 得 
困难 而 琐碎 。 很 多 工具 都 包含 花 里 胡 哨 的 附属 功能 , 但 可 能 永远 不 会 在 TDD 中 应 用 。 有 些 工具 有 
不 同 的 设计 考虑 ， 比 如 最 小 内 存 占 用 ， 因 此 可 能 包含 了 一 些 与 IDD 的 目标 相 冲突 的 特性 。 


在 我 看 来 ， 下 列 特性 是 测试 驱动 开发 时 必需 的 。 


特 性 说 明 


独立 的 测试 名 称 每 个 测试 都 能 被 唯一 标识 (倾向 于 使 用 “范围 、 集 合 、 测 试 ” 的 组 合 名 称 )。 至 少 有 一 个 工具 支 
持 事 后 为 测试 添加 名 称 ， 上 默认 情况 下 仅 用 数字 表示 测试 
易于 增加 新 的 测试 。 测试 应 该 自动 注册 ， 以 便 默认 执行 。 工 具 不 应 该 要 求 程序 员 分 别 注册 定义 好 的 测试 。 像 CppUnit 




































































































































































的 一 些 旧 工具 需要 程序 员 显示 地 将 新 增 的 测试 注册 到 测试 集中 

支持 fixture 支持 定义 提供 设置 、 回 收 函 数 的 fixture， 将 通用 的 辅助 函数 集中 起 来 
独立 的 测试 每 一 个 单元 测试 都 能 独立 运行 ， 不 依赖 于 任何 其 他 单元 测试 的 输出 
判断 相等 性 比较 两 个 数量 是 否 相等 ， 提 供 清晰 、 有 表现 力 的 出 错 信息 
测试 套件 能 运行 任意 单元 测试 的 集合 
支持 mock 提供 一 套 简易 定义 和 使 用 mock 的 方法 ， 或 者 提供 对 第 三 方 mocking 工 具 的 链接 支持 

下 列 的 特性 并 非 必 需 , 但 可 以 给 TDD 提 供 帮 助 。 

"ood 说 — 明 
Hamcrest 提供 增强 的 断言 功能 以 支持 匹配 器 (并 支持 自 定义 匹配 器 )。 维持 TDD 要 求 测试 具有 高 度 可 读 性 ， 

















Hamcrest 有 助 于 实现 这 个 目标 
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( 续 ) 
特 性 说 BB 
定制 化 输出 提供 定制 化 输出 的 功能 。 默 认 情况 下 ， 工 具 应 该 提供 一 个 显示 测试 失败 细节 的 简要 总 结 
对 异常 的 断言 提供 一 种 直接 的 方法 以 断言 抛 出 的 异常 
测试 的 统计 结果 ”提供 测试 运行 的 统计 信息 ， 以 及 每 个 测试 执行 的 次 数 
内 存 泄 漏 测 试 提供 一 种 可 配置 的 管理 机 制 来 监测 内 存 泄漏 ， 比 如 一 个 测试 申请 了 内 存 却 没有 释放 
健壮 性 即使 有 些 测试 抛 出 异常 或 者 应 用 程序 崩溃 ， 测 试 集 依然 可 以 完成 运行 (在 持续 集成 服务 器 上 运 
行 测试 时 ， 这 个 特性 尤为 重要 ) 
下 列 特性 虽然 看 上 去 不 错 ,， 但 和 TDD 没 有 关系 。 
特 性 说 BB 
参数 化 的 测试 你 可 能 会 发 现 : 在 某 些 罕 见 情形 下 ， 向 一 个 测试 发 送 很 多 数据 是 非常 有 用 的 。 然 而 测试 驱动 并 
非 如 此 ， 且 即使 需要 独立 编写 代码 ， 那 也 是 相当 简单 的 
依赖 性 对 集成 测试 而 言 ， 让 其 按照 指定 顺序 执行 是 非常 有 用 的 。 但 创建 对 其 他 测试 结果 有 依赖 关系 的 








测试 ， 对 TDPD 来 说 毫 


无 意义 


A1.3 Google Mock 的 说 明 


Google Mock 为 mock 提 供 了 内 艇 的 支持 ， 还 提供 

















了 一 个 应 用 广泛 的 Hamcrest 库 。 


Google Mock 不 完全 支持 测试 套件 。 它 支持 通过 命令 行 过 滤 的 方式 运行 一 部 分 测试 ,但 对 固 
定 不 变 的 测试 套件 不 提供 支持 ( 可 以 重 定向 输入 为 一 组 文件 ， 绕 开 这 个 缺陷 )。 








遗憾 的 是 ， 上 默认 情况 下 Google Mock 的 输出 结 
来 说 ， 如 果 不 借助 命令 行 操 作 ， 要 想 从 大 量 的 测试 输出 中 找 出 失败 测试 的 信 ， 


为 了 解决 这 个 问题 , 可 以 创建 一 个 自 定义 的 测试 事件 监听 程序 , 每 隔 儿 分 




















E 
U^ 


包含 了 所 有 的 测试 信息 。 对 于 大 的 测试 套件 





第 会 异常 困难 。 

















' 就 输出 简化 后 的 


Google Test 执 行 信息 。 更 多 信息 请 参见 https://code.google.com/p/googletest/wiki/AdvancedGuide# 
Extending Google Test by Handling Test Events 





A1.4  CppUTest 的 说 明 
CppUTest 提 供 了 对 TDD 单 元 测试 工具 来 说 非常 重要 的 绝 大 多 数 特性 , 同时 也 支持 通过 命令 行 


切换 的 方式 运行 议 











I 试 的 一 个 子 集 ， 和 Google Test 的 过 滤器 非常 类 似 ， 但 没有 那么 稳定 。 


CppUTest 还 具有 一 个 非常 重要 的 特性 一 一 支持 内 存 汇 漏 监测 , 这 个 特性 可 以 和 其 他 单元 测试 
工具 结合 起 来 使 用 。 
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A1.5 其 他 单元 测试 框架 
你 可 能 考虑 到 了 下 表 列 出 的 一 些 单元 测试 框架 。 








单元 测试 框架 链 gk 
Boost.Test http://www.boost.org/doc/libs/1 53 O/libs/test/doc/html/index.html 
CppUnit http://cppunit.sourceforge.net/doc/1.11.6/cppunit cookbook.html 
CppUnitLite http://c2.com/cgi/wiki?CppUnitLite 
CUTE http://cute-test.com/ 
CxxTest http://cxxtest.com/ 
Unit http://unitpp.sourceforge.net/ 


A1.6 结束语 


C++ 单元 测试 工具 在 继续 演化 。 这 个 附录 的 目的 是 帮助 你 制定 一 套 准 则 ， 用 以 选择 团队 所 需 
的 单元 测试 开发 工具 , 而 不 是 总 结 截止 到 本 书 出 版 为 止 的 所 有 单元 测试 工具 。 有 些 网 站 提供 了 可 
用 工具 的 对 比 。http://gamesfromwithin.com/exploring-the-c-unit-testing-framework-jungle 中 的 文章 
详细 比较 了 几 个 工具 ， 请 注意 ， 这 篇 文章 写 于 2010 年 ， 没 有 讨论 到 CppUTest 和 Google Test. 


一 般 来 说 , 对 适合 的 C++ 单元 测试 工具 的 选择 不 会 大 错 特 错 。 你 的 工具 会 随 着 时 间 越 来 越 好 ， 
即便 不 是 这 样 ， 你 还 有 机 会 定制 它 。 因 此 ， 选 择 一 个 工具 ， 开 始 你 的 旅程 吧 。 









































代码 Kata: 罗马 数字 转换 器 








B.1 开场 白 


在 11.5 节 中 ,你 了 解 了 使 用 Katas 有 助 于 加 固 基 本 的 TDD 概 念 ， 特 别 是 构建 解决 方案 的 增 量 
方法 。 本 附录 提供 了 一 个 Kata 供 训练 之 用 。 通 过 一 个 个 测试 ， 你 将 测试 开发 出 罗马 数字 转换 器 
的 实现 。 









































B.2 出 发 吧 
我 们 要 构建 什么 ? 


m: 罗马 数字 转换 器 
我 们 需要 一 个 函数 ， 它 接受 一 个 阿拉 伯 数 字 ,， 返回 一 个 与 之 对 应 的 罗马 数字 ( 以 字 
符 串 的 形式 )。 





通过 第 一 个 测试 要 花费 几 分 钟 ， 因 为 要 做 一 定量 的 初始 化 工作 ( 创建 构建 脚本 、 加 上 头 文件 
和 包含 语句 ， 等 等 )。 也 要 作 一 些 决定 : 测试 方法 的 名 称 是 什么 ?函数 接口 应 该 是 什么 样子 的 ? 


我 们 将 转换 器 作为 自由 函数 。 下 面 是 第 一 个 失败 的 测试 : 






































roman/1/RomanConverterTest.cpp 


TEST(RomanConverter, CanConvertPositiveDigits) 1 
EXPECT THAT(convert(1), Eq("I")); 
} 


Kata 的 一 个 目的 是 最 小 化 我 们 的 步伐 。 虽然 我 不 喜欢 自由 函数 , 但 如 果 只 是 纯粹 的 功能 需求 ， 
它们 确实 是 很 好 的 开始 。 一 旦 功能 完成 ， 必 要 时 可 以 将 其 变 为 类 静态 成 员 函 数 。 
为 了 让 事情 变 得 更 简单 ， 暂 时 先 将 测试 和 convert() 实 现 放 在 同一 个 文件 中 。 下 面 是 整个 文 
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件 的 内 容 ， 其 中 包括 能 让 第 一 个 测试 通过 的 代码 。 





roman/2/RomanConverterTest.cpp 
#include "gmock/gmock.h" 


using namespace ::testing; 
using namespace std; 


string convert(unsigned int arabic) 


{ 


return "I"; 


} 


TEST(RomanConverter, CanConvertPositiveDigits) { 
EXPECT THAT(convert(1), Eq("I")); 
} 


继续 向 前 推进 。 转 换 数字 2 似乎 是 最 适合 的 下 一 步 。 








roman/3/RomanConverterTest.cpp 


TEST(RomanConverter, CanConvertPositiveDigits) { 
EXPECT THAT(convert(1), Eq("I")); 
EXPECT THAT(convert(2), Eq("II")); 


你 或 许 注 意 到 了 上 面 用 的 是 EXPECT_THAT ， 而 非 我 所 喜爱 的 ASSERT_THAT。 提 示 一 下 它们 的 
区 别 ， 如 果 EXPECT_THAT 晰 言 失败 ，Google Test 将 继续 运行 当前 测试 。 但 如 果 ASSERT_THAT 晰 言 
失败 ，Google Test 将 停止 执行 当前 测试 。 

通常 而 言 , 你 想 要 为 每 一 个 测试 函数 准备 一 个 场景 一 一 一 个 单独 的 测试 用 例 。 在 单独 的 测试 
用 例 中 ， 在 断言 失败 后 继续 运行 测试 意义 不 大 ， 因 为 余下 的 测试 逻辑 通常 也 会 失效 。 

就 罗马 数字 转换 器 而 言 , 创建 新 的 测试 方法 意义 不 大 , 因为 外 部 表现 的 行为 ( 转换 一 个 数字 ) 
在 新 的 测试 用 例 中 没有 改变 。 如 果 对 两 个 测试 用 例 使 用 不 同 的 方法 ,函数 名 会 变 得 乏味 而 且 没 什 
么 价值 : Convert1、Convert2。 

因为 一 个 测试 函数 有 许多 测试 用 例 , 所 以 使 用 EXPECT_THAT 更 加 合理 。 如 果 一 个 断言 失败 了 ， 
我 们 仍然 想 知道 其 他 的 测试 用 例 通 过 了 还 是 失败 了 。 

为 了 让 第 二 个 断言 通过 ， 这 里 引入 if 语 句 ， 将 数字 2 的 转换 看 作 一 个 新 的 情况 。 这 是 我 们 到 
目前 为 止 知道 的 全 部 内 容 。 我 们 有 两 个 测试 用 例 一 一 数字 1 和 数字 2 一 一 我 们 写 的 代码 反映 了 我 们 
的 知识 。 







































































roman/3/RomanConverterTest.cpp 


string convert(unsigned int arabic) 
{ 
if (arabic == 2) 
return "II"; 
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return "I"; 


} 
下 面 是 第 三 个 断言 : 

















roman/4/RomanConverterTest.cpp 
EXPECT THAT(convert(3), Eq("III")); 
} 


这 时 我 们 察觉 到 了 一 个 模式 ， 可 添加 简单 的 循环 来 使 用 它 。 





roman/4/RomanConverterTest.cpp 


string convert(unsigned int arabic) 
1 
string roman(""); 
while (arabic-- » 0) 
roman += "I"; 
return roman; 


} 


简单 ， 简 单 。 我 们 还 没 考虑 优化 。 因 此 ， 就 目前 来 说 ， 能 连 成 字符 串 已 经 够 好 了 ，for 语 名 
似乎 是 不 必要 的 。 


B.2.2 数字 10， 先 生 ! 


1，2，3…… 准 备 好 4 了 吗 ? 没有 必要 。TDD 并 不 强迫 以 特定 的 顺序 构建 测试 。 相 反 ， 我 们 应 
该 思考 一 番 ， 下 一 个 测试 应 该 是 什么 。 


罗马 字符 TIV CA) 是 一 个 减法 ， 即 比 数字 V( 5 ) 小 1 (1 )。 我 们 还 没有 考虑 数字 5( V ), 或 许 
至 少 在 处 理 数字 5 后 ， 再 回头 看 看 数字 4。 至 于 V， 它 似乎 是 一 个 简单 的 特例 。 或 许 应 该 先 思 
下 到 目前 为 止 哪 些 是 类 似 的 。1、2 、3 的 结果 是 递增 的 [、I 工 、IIL。 KES ARDENNE: 
X, XX, XXX, 



























































roman/5/RomanConverterTest.cpp 
EXPECT THAT(convert(10), Eq("X")); 


数字 10 是 另 一 个 特例 ， 最 适合 用 if 语句 处 理 。 





roman/5/RomanConverterTest.cpp 


string convert(unsigned int arabic) 
1 
string roman(""); 
if (arabic -- 10) 
return "X"; 
while (arabic-- » 0) 
roman += "I"; 
return roman; 
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数字 11 应 该 更 有 趣 。 


roman/6/RomanConverterTest.cpp 
EXPECT THAT(convert(11), Eq("XI")); 


roman/6/RomanConverterTest.cpp 


string convert(unsigned int arabic) 
1 
string roman(""); 
if (arabic »- 10) 
1 
roman += "X"; 
arabic -- 10; 
} 
while (arabic-- > 0) 
roman += "I"; 
return roman; 


} 


如 果 转 换 器 接受 了 一 个 大 于 10 的 数字 , 追加 一 个 X, 从 数字 中 减 去 10, 继续 执行 相同 的 while 
循环 。 数 字 12 和 13 的 断言 应 该 可 以 自动 通过 。 


roman/6/RomanConverterTest.cpp 


EXPECT THAT(convert(12), Eq("XII")); 
EXPECT THAT(convert(13), Eq("XIII")); 


两 个 断言 确实 通过 了 。 数 字 20 的 断言 却 失败 了 。 








roman/7/RomanConverterTest.cpp 
EXPECT_THAT (convert(20), Eq("XX")); 


只 要 将 关键 字 if 改 为 while 就 可 以 通过 测试 了 。 























roman/7/RomanConverterTest.cpp 


string convert(unsigned int arabic) 
{ 
string roman{""}; 
while (arabic >= 10) 
{ 
roman += "X"; 
arabic -- 10; 
H 
while (arabic-- » 0) 
roman += "I"; 
return roman; 
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B.2.3 ”欲擒故纵 


我 们 获得 了 一 个 似乎 有 重复 代码 的 实现 。while 循 环 有 点 类 似 。 面 对 “几乎 重复 ”， 下 一 步 
是 让 它们 变 得 更 加 相像 。 





roman/8/RomanConverterTest.cpp 


string convert(unsigned int arabic) 
{ 
string roman{""}; 
while (arabic >= 10) 
{ 
roman += "X"; 
arabic -= 10; 


while (arabic »- 1) 
1 
roman += "I"; 
arabic -= 1; 
} 


return roman; 


} 

重 构 后 ， 上 述 两 个 循环 有 相同 的 逻辑 ， 只 是 数据 不 一 样 。 我 们 可 以 提取 公有 函数 来 杜绝 重复 
代码 , 但 这 似乎 不 是 高 明 的 选择 ,因为 两 个 分 隔 元 素 会 变化 (阿拉伯 数 字 的 和 与 罗马 数字 符 串 )。 
现在 来 提取 转换 表 吧 。 


























roman/9/RomanConverterTest.cpp 
string convert(unsigned int arabic) 
1 
const auto arabicToRomanConversions = { 
make pair(10u, "X"), 
make pair(1lu, "I") Y; 
string roman(""); 
for (auto arabicToRoman: arabicToRomanConversions) 
while (arabic >= arabicToRoman.first) 
1 
roman += arabicToRoman.second; 
arabic -= arabicToRoman.first; 
} 
return roman; 


} 
这 个 重复 的 循环 变 成 了 通用 的 循环 ， 成 为 了 遍历 转换 表 的 一 部 分 。 
B.2.4 收尾 工作 


我 们 所 说 的 算法 是 这 样 的 : 对 于 每 一 对 阿拉 伯 数 字 与 罗马 数字 映射 , 减 去 阿拉 伯 数 值 ， 然 后 
追加 相应 的 罗马 数值 ， 直 到 余数 小 于 阿拉 伯 数 字 。( 可 以 使 用 不 同 的 数据 结构 ， 但 要 确保 转换 映 
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射 按 从 大 到 小 顺序 遍历 。) 


细 想 一 下 就 会 发 现 , 算法 能 够 应 对 所 有 的 数字 映射 ,只 需要 将 其 加 进 表 中 。 我 们 来 试 一 下 之 
前 当成 特例 考虑 的 数字 5。 


roman/10/RomanConverterTest.cpp 
EXPECT THAT(convert(5), Eq("V")); 


只 需要 向 转换 表 中 加 入 一 项 ， 测 试 就 会 通过 。 








roman/10/RomanConverterTest.cpp 


const auto arabicToRomanConversions = { 
make pair(10u, "X"), 
» make pair(5u, "V"), 
make pair(1lu, "I") Y; 


现在 写 测 试 主要 是 为 了 增强 信心 (参见 3.5 节 )， 因 为 除了 向 转换 表 中 加 入 数据 ， 我 们 什么 也 
没 做 ， 但 是 这 就 可 以 了 。 再 多 一 些 这 类 测试 吧 ! 50. 100, 或 者 组 合 起 来 ? 





























roman/11/RomanConverterTest.cpp 


EXPECT THAT(convert(50), Eq("L")); 

EXPECT THAT(convert(80), Eq("LXXX")) ; 

EXPECT THAT(convert(100), Eq("C")); 

EXPECT THAT(convert(288), Eq("CCLXXXVIII")); 











我 们 发 现 ， 这 些 测试 也 很 容易 通过 ， 只 需要 向 转换 表 中 加 入 必要 的 转换 项 即 可 。 











roman/11/RomanConverterTest.cpp 


const auto arabicToRomanConversions = { 
make pair(100u, "C"), 
make pair(50u, "L"), 
make pair(10u, "X"), 
make pair(5u, "V" 
make pair(1lu, "I") }; 


最 后 ， 再 一 次 见 到 了 我 们 一 直 规 避 的 挑战 。 数 字 4 怎 么 处 理 呢 ? 


), 
) 








roman/12/RomanConverterTest.cpp 
EXPECT THAT(convert(4), Eq("IV")); 


我 们 可 以 尝试 通过 引入 一 点 减法 逻辑 来 支持 数字 4。 但 这 样 做 似乎 给 我 们 的 代码 带 来 了 一 些 
复杂 的 逻辑 演 路 和 盘 杂 的 9 条 件 分 支 。 TR série 


记 住 ,TDD 不 是 无 脑 练习 (参见 3.3 节 ), 每 一 步 都 需要 深思 熟 虑 ， 包 括 下 一 步 该 是 什么 样 。 
就 目前 而 言 , 编写 可 以 驱动 开发 一 个 更 简单 实现 的 测试 行为 对 我 们 来 说 已 经 非常 奏效 了 , 因为 它 
反映 了 相似 的 模式 。 确保 代码 在 每 一 步 都 能 被 正确 重 构 ,能 够 提高 我 们 遵循 这 一 不 断 简化 的 路 数 
的 能 力 。 
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偶尔 需要 更 深刻 的 洞察 力 才能 达到 最 佳 结果 。 有 时 它们 来 的 很 容易 ， 有 时 却 很 难 。 编 写 的 程 
































序 越 多 , 探寻 的 东西 越 多 , 灵光 一 现 的 机 会 就 越 多 。TDD 很 棒 的 一 点 是 , 它 提 供 了 这 些 实践 机 会 。 


尝试 更 好 的 代码 ， 你 很 快 就 能 


如 果 将 罗马 数字 4 作为 单独 
单独 的 特殊 字符 来 表征 它 。 这 检 





道 它 是 否 工作 。 如 果 不 能 ， 那 么 就 回 深 掉 代码 并 尝试 其 他 方案 。 


的 数字 ， 不 考虑 它 需 要 两 个 字母 (IV ) 呢 ? 璧 如， 试想 罗马 人 用 
的 话 ， 它 仅仅 是 转换 表 中 的 另 一 个 简单 项 。 





roman/12/RomanConverterTest.cpp 


const auto arabicToRomanConversions = { 


make pair(100u, "C"), 
make pair(50u, "L"), 
make pair(10u, "X"), 
make pair(5u, "V"), 
» make pair(4u, "IV"), 
make pair(1lu, "I") }; 











整个 算法 没有 变 。 最 后 以 最 


终 断 言 收尾 ,这 些 断 言 验证 了 算法 对 其 他 基于 减法 的 数字 的 支持 ， 





包括 9、40、90、400 和 900, 还 有 一 些 没有 添加 的 数字 (500 和 1000 )。 对 于 这 些 断 言 ， 我 将 convert 
n to roman 作 为 Google 搜 索 关 键 字 ， 然 后 把 获得 的 结果 当 作 断言 中 的 期 望 值 ”。 











roman/13/RomanConverterTest.cpp 


#include "gmock/gmock.h" 


#include <vector> 
#include <string> 


using namespace ::testing; 
using namespace std; 


string convert(unsigned int 


{ 


arabic) 


const auto arabicToRomanConversions = { 
make pair(1000u, "M"), 
make pair(900u, "CM"), 


make pair(500u, "D"), 


make pair(400u, "CD"), 


make pair(100u, "C"), 
make pair(90u, "XC"), 
make pair(50u, "L"), 
make pair(40u, "XL"), 
make pair(10u, "X"), 
make pair(9u, "IX"), 
make pair(5u, "V"), 

make pair(4u, "IV") 

make pair(1lu, "I") }; 


string roman(""); 





Qn 是 阿拉 伯 数 字 。 一 一 译 者 注 
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for (auto arabicToRoman: arabicToRomanConversions) 
while (arabic >= arabicToRoman.first) 


1 
roman += arabicToRoman.second; 
arabic -= arabicToRoman.first; 
j 
return roman; 


} 


TEST(RomanConverter, CanConvertPositiveDigits) { 
EXPECT THAT(convert(1), Eq("I")); 
EXPECT THAT(convert(2), Eq("II")); 
EXPECT THAT(convert(3), Eq("III")); 
EXPECT THAT(convert(4), Eq("IV")); 
EXPECT THAT(convert(5), Eq("V")); 
EXPECT THAT(convert(10), Eq("X")); 
EXPECT THAT(convert(11), Eq("XI")); 
EXPECT THAT(convert(12), Eq("XII")); 
EXPECT THAT(convert(13), Eq("XIII")); 
EXPECT THAT(convert(20), Eq("XX")); 
EXPECT THAT(convert(50), Eq("L")); 
EXPECT THAT(convert(80), Eq("LXXX")) ; 
EXPECT THAT(convert(100), Eq("C")); 
EXPECT THAT(convert(288), Eq("CCLXXXVIII")); 
EXPECT THAT(convert(2999), Eq("MMCMXCIX")); 
EXPECT THAT(convert(3447), Eq("MMMCDXLVII")); 
EXPECT THAT(convert(1513), Eq("MDXIII")); 
} 


大 功 告 成 ! (除了 一 个 限定 ， 即 数字 必须 在 1~4000 )。 





























我 们 最 终 得 到 了 一 个 简短 、 简 单 且 准确 的 算法 实现 。 在 网 上 搜索 一 下 就 能 得 到 许多 其 他 解决 
得 











方案 , 它们 远 比 这 复杂 ,而 且 没 有 任何 其 他 多 余 的 优点 。 遵 循 TDD 并 正确 重 构 总 是 能 够 





的 解决 方案 。 


B.3 AAI 
如 果 你 还 没有 做 ， 那 就 按照 本 附录 中 的 步骤 完成 罗马 数字 转换 器 的 构建 


Tr 











到 优化 


。 但 不 要 止步 于 此 ， 

















再 实现 一 遍 这 个 转换 器 ,这 一 次 不 要 参考 书 中 的 步 又。 思考 下 一 步 该 怎么 做 、 编 写 一 个 测试 、 找 








一 个 简单 的 方法 实现 代码 并 重 构 代 人 码 。 然 后 再 做 一 遍 一 一 不 用 立刻 做 ， 或 许 








一 天 或 者 一 周 以 后 。 








每 次 做 的 时 候 都 要 记 下 时 间 , 努力 减少 敲 击 键盘 的 次 数 和 完成 整个 方案 所 需要 的 精力 。 如 果 你 已 


经 有 一 段 时 间 不 用 TDD 或 CH+ 了 ， 可 以 以 此 作为 热身 训练 。 


B.4 结束语 


























本 附录 中 的 另 一 个 示例 展示 了 怎样 利用 TDD 增 量 地 开发 一 个 算法 。 当 然 , 事情 并 不 总 是 那么 


附录 B 代码 Kata: 罗马 数字 转换 器 281 





顺利 。 遇 到 新 问题 时 ， 可 能 会 选 错 出 发 点 ， 这 时 需要 撤销 少量 代码 ， 重 新 尝试 。 以 罗马 转换 器 这 
类 短小 的 Kata 来 练习 ， 可 以 让 你 对 采取 短小 、 增 量 的 方式 达成 解决 方案 感到 更 加 舒适 。Kata 的 更 
多 相关 细节 可 以 参见 11.5 节 。 
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